simple URL shortener
906a34a0 — koehr 3 years ago
deactivate sourcehut build bot for now
ea6b84ed — koehr 3 years ago
get rid of all this SQL nonsense and use sled
45970d22 — koehr 3 years ago
start to implement URL expiry


browse  log 



You can also use your local clone with git send-email.


builds.sr.ht status MIT license

A very performant URL shortener service for individuals and small groups.

The service builds upon the Actix web framework and Sled for data handling. Thanks to Actix and the in-memory database you can expect 100k requests handled per second on consumer hardware (my laptop).

#Quick Start

The database will be automatically initialized with a super user if it is not yet existing. The api key can be found in the programs output, which should look similar to the following example:

$ k0r
Database file k0r.db not found. Will be created!
Added first user with api key 859b397c-a933-461d-a9b1-86dd20084c02
Server is listening on

This will create a database file in the current directory. You can also give a path instead:

$ k0r /path/to/database.db

For testing, you can fill the database with test URLs using the application API. There is a helper script and already a file with example URLs inside the db folder:

# assuming you're inside the project directory root and the server is running
./db/insert-via-api.sh 859b397c-a933-461d-a9b1-86dd20084c02 db/test.urls

This inserts a bit under two-hundred URLs fetched from 250kb.club a while ago. The file contains simply one URL per line and the script is not doing any checks and will throw at the API whatever it finds.

#API Usage

Get an URL is straight forward as expected:

$ curl
<!DOCTYPE html>
<html lang="en">
  <meta charset="UTF-8">
  <title>redirect — k0r link shortener service</title>
  <meta http-equiv="refresh" content="2; url=https://example.com" />
<body>You will be redirected to <a href="https://example.com">an example</a>.</body>

Inserting a URL is simple as well:

$ payload='{
    "title":"an example",
    "description":"totally examplary url",
$ curl -X POST localhost:8080 -H 'Content-Type: application/json' -d $payoad

#Planned features

This software is still pre-alpha state and most of the planned features are not yet implemented. See the todo list for more information about the planned features and current state of implementation.