Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
ready to go heroku hosted URL shortener based on guillotine
branch: master
Failed to load latest commit information.
Gemfile update to guillotine 1.4.0
Gemfile.lock update to guillotine 1.4.0
LICENSE add LICENSE add codeclimate banner
app.rb don't strip query and achor params add basic app

Katana Code Climate


Opinionated personal URL shortener which runs on Heroku and uses Redis to go as a backend. Shortening is done through the fabulous Guillotine engine and its Redis adapter.

If you set HTTP_USER and HTTP_PASS all methods except GETs require basic authentication.


You can use it exactly as any other guillotine app:

curl -X POST http://sho.rt --user foo:bar -i -F"url=" -F"code=gh"


  • Authentication
  • Custom Tweetbot compatible endpoint
  • Gauges support (to come)


git clone git://
cd katana
heroku create
heroku addons:add redistogo
heroku domains:add sho.rt
git push heroku master
# for gauges support
heroku config:add GAUGES_TOKEN="token"
heroku config:add GAUGES_GAUGE="gauge"
# for authentication
heroku config:add HTTP_USER="theuser"
heroku config:add HTTP_PASS="thepass"


There is a custom endpoint which is compatible with how tweetbot expects custom URL shorteners to behave. Activate it by setting


in your environment variables. After that you can add URLs with a GET to


Keep in mind that this endpoint is not authenticated.


@technoweenie for the awesome guillotine and @roidrage for s3itch which somehow got me started wanting a personal URL shortener.

Something went wrong with that request. Please try again.