Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

A reusable Django app that adds a link shortener like to your site.

Project description

A Django application that adds an URL shortener to your site similar to


You need to install the following prerequisites in order to use this app:

pip install django
pip install requests

When using Python 2.6, you will also need to install importlib.

If you want to install the latest stable release from PyPi:

$ pip install django-tinylinks

If you feel adventurous and want to install the latest commit from GitHub:

$ pip install -e git://

Add tinylinks to your INSTALLED_APPS:


Add the tinylinks URLs to your

urlpatterns = [
    url(r'^s/', include('tinylinks.urls')),

Don’t forget to migrate your database:

./ migrate tinylinks



Just visit the root URL of the app. Let’s assume you hooked the app into your at s/, then visit You will see your tinylist overview. Go to to see a form to submit a new long URL.

After submitting, you will be redirected to a new page which shows the generated short URL. If you want this URL to have a different short URL, just change the short URL to your liking.

Now visit and you will be redirected to your long URL.


If you want to contribute to this project, please perform the following steps

# Fork this repository
# Clone your fork
mkvirtualenv -p python2.7 django-tinylinks
make develop

git co -b feature_branch master
# Implement your feature and tests
git add . && git commit
git push -u origin feature_branch
# Send us a pull request for your feature branch

In order to run the tests, simply execute tox. This will install two new environments (for Django 1.8 and Django 1.9) and run the tests against both environments.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-tinylinks, version 0.7.1
Filename, size File type Python version Upload date Hashes
Filename, size django-tinylinks-0.7.1.tar.gz (17.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page