mirror of https://github.com/itsmrval/ltsNinja
125 lines
3.1 KiB
Markdown
125 lines
3.1 KiB
Markdown
<br />
|
|
<div id="readme-top" align="center">
|
|
<a href="https://github.com/itsmrval/ltsninja">
|
|
<img src="https://raw.githubusercontent.com/itsmrval/ltsNinja/main/static/img/logo.svg" alt="Logo" width="120" height="120">
|
|
</a>
|
|
|
|
<h3 align="center">ltsNinja</h3>
|
|
|
|
<p align="center">
|
|
Simple and lightwell url shortener running GO.
|
|
<br />
|
|
<br />
|
|
<a href="https://lts.ninja">Explore demo</a>
|
|
·
|
|
<a href="https://github.com/itsmrval/ltsninja/issues">Report Bug</a>
|
|
·
|
|
<a href="https://github.com/itsmrval/ltsninja/pulls">Pull request</a>
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<details>
|
|
<summary>Table of contents</summary>
|
|
<ol>
|
|
<li>
|
|
<a href="#about-the-project">What is ltsNinja ?</a>
|
|
<ul>
|
|
<li><a href="#built-with">Built with</a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href="#getting-started">Getting started</a>
|
|
<ul>
|
|
<li><a href="#installation">Installation</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#roadmap">Roadmap</a></li>
|
|
<li><a href="#license">License</a></li>
|
|
</ol>
|
|
</details>
|
|
|
|
|
|
|
|
## What is ltsNinja
|
|
|
|
Homepage | Dashboard
|
|
:-------------------------:|:-------------------------:
|
|
 | 
|
|
|
|
|
|
ltsNinja is a public, self-hosted tool that makes it easy to shorten urls. It's very lightweight and intuitive, which means it runs with very little performance.
|
|
|
|
Few key points:
|
|
* Github login for custom links
|
|
* Easy dashboard for users
|
|
|
|
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
|
|
|
### Built With
|
|
|
|
This section list major frameworks/libraries used
|
|
|
|
* 
|
|
* 
|
|
* 
|
|
* 
|
|
* 
|
|
|
|
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
|
|
|
|
|
|
|
## Getting Started
|
|
|
|
Now let's see how to set up an ltsNinja instance.
|
|
|
|
### Installation
|
|
|
|
1. Create directory
|
|
```sh
|
|
mkdir /opt/ltsNinja
|
|
cd /opt/ltsNinja
|
|
```
|
|
2. Download the latest release
|
|
```sh
|
|
wget -O ltsNinja https://github.com/itsmrval/ltsNinja/releases/download/0.1.0/ltsNinja_linux_amd64
|
|
```
|
|
3. Download the example env
|
|
```sh
|
|
wget -O .env https://github.com/itsmrval/ltsNinja/releases/download/0.1.0/example.env
|
|
```
|
|
4. Complete `.env`
|
|
* GITHUB_CLIENT_ID & GITHUB_CLIENT_SECRET with your [Github app](https://github.com/settings/developers)
|
|
* GITHUB_REDIRECT_URL replacing the APP URL
|
|
|
|
6. Run it
|
|
```js
|
|
chmod +x ltsNinja
|
|
./ltsNinja
|
|
```
|
|
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
|
|
|
|
|
|
|
|
|
|
|
## Roadmap
|
|
|
|
- [x] URL Shortener
|
|
- [x] Custom links
|
|
- [x] User dashboard
|
|
- [x] Edit with github
|
|
- [ ] Admin dashboard
|
|
|
|
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
|
|
|
|
|
|
|
<!-- LICENSE -->
|
|
## License
|
|
|
|
Distributed under the MIT License. See `LICENSE.txt` for more information.
|
|
|
|
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|