Skip to content

Repository files navigation

Linkling

Do you dislike cloud-based bookmark services, but don't want to self-host? Then consider Linkling bookmark server, which stores bookmarks in simple JSON files.

Linkling aims to implement the Linkding and Linkwarden APIs for compatiblity with those ecosystems.

Currently, Linkling is compatible with the following projects:

One goal of this project is to support Floccus, the Syncthing of the bookmark world, by leveraging the current Linkwarden integration.

Installation

Installers are available for Windows and Linux via Flatpak (see Releases). Linkling is a headless server, so do not expect a GUI. However, there is a tray icon with a context menu.

By default, the Flatpak can't access external collections due to Flatpak sandboxing. Use Flatseal to grant the Flatpak access to an external directory.

FAQ

Is this suitable for multiple users?

Linkling isn't suitable for sharing bookmarks, no. If you're going to self-host, use a fully-fledged bookmark server.

You can sync the JSON bookmark collections using a cloud storage provider, but merge conflicts are likely if two users simultaneously modify the database.

Warning

As of current version, Linkling does not detect external changes while running.

Development

Node 26+ required.

Install Dependencies

npm install

Additional dependencies required for flatpak only:

  • flatpak
  • flatpak-builder
  • Freedesktop 26.08 runtime

Start Server

npm start

Package Flatpak

npm run build       # creates portable single executable
npm run package     # creates flatpak

Output is available under dist/flatpak/package.

Testing

Benchmark test uses Grafana k6.

Performance is mainly bottlenecked by the filesystem.

For the server itself, >10k bookmarks per collection is no issue in practice. Clients may have their own problems with collections this large.

Attribution

The icons located in /assets are sourced from the Twemoji project. Copyright 2019 Twitter, Inc and other contributors. These graphics are licensed under CC-BY 4.0.

About

JSON-based bookmark server. Linkding compatible.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages