Add contente to README

This commit is contained in:
Quantum 2022-01-24 20:39:51 -05:00
parent f289efd676
commit af14bd855f
2 changed files with 30 additions and 2 deletions

View file

@ -1,2 +1,30 @@
# qlinks
Private self-hosted URL shortener with focus on link management
# QLinks
Self-hosted URL shortener with focus on link management for private use.
QLinks is not a normal URL shortener — it does not allow anyone on the Internet
to shorten any URLs and return some gibberish URL.
**QLinks is a tool to curate a collection of short links.**
## Features
* Automatically detect broken links;
* Support for CDN cache purging, allowing redirects to be cached at the edge
(currently only Cloudflare is supported); and
* An amazing admin interface, powered by Django's admin site:
[![QLinks Admin Site](demo.png)](demo.png)
## Installation
```sh
git clone https://github.com/quantum5/qlinks.git
cd qlinks
python -m venv env --prompt qlinks
. env/bin/activate
pip install -r requirements.txt
cp qlinks/settings/template.py qlinks/settings/local.py
# Edit qlinks/settings/local.py to configure QLinks like a normal Django project.
python manage.py runserver
```
Once you are satisfied with the way QLinks works, load up
`qlinks.project.wsgi:application` in any WSGI-compliant application server.

BIN
demo.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 267 KiB