Fork 0
Go to file
forest c4e33a08ea add "what it does" to readme 2024-01-04 23:15:30 -06:00
embed forest's usability changes and fix html template encoding issue 2024-01-04 22:54:07 -06:00
extra prettify, convert line endings to unix format 2023-05-21 15:07:33 -05:00
.editorconfig embed static files, serve at /* 2023-12-28 16:27:18 -06:00
.gitignore forest's usability changes and fix html template encoding issue 2024-01-04 22:54:07 -06:00
LICENSE.txt start of golang rewrite 2023-12-27 16:49:11 -06:00
config.go add more config options, create favicon.ico 2023-12-30 18:54:33 -06:00
flake.lock fix nixos module. ready for v2 release 2024-01-01 17:00:15 -06:00
flake.nix flake: bump version, use fetchgit, fix deprecated string type 2024-01-03 11:39:48 -06:00
go.mod forest's usability changes and fix html template encoding issue 2024-01-04 22:54:07 -06:00
go.sum forest's usability changes and fix html template encoding issue 2024-01-04 22:54:07 -06:00
main.go add content type headers 2024-01-04 23:02:19 -06:00
readme.md add "what it does" to readme 2024-01-04 23:15:30 -06:00
roadmap.md include version number in generator tag 2024-01-02 18:20:21 -06:00



Reticule is an extremely minimal, self-hosted alternative to bookmarking services like Pocket/Instapaper/Wallabag that relies on a feed reader of your choice (like Miniflux, Vore, Newsboat, and others) to view your saved links.

What it does:

$ curl http://localhost:8080/feed?key=EXAMPLE
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom">

	<generator>Reticule (devel)</generator>
	<pubDate>2024-01-04 23:13:24.763009482 -0600 CST</pubDate>
		<description>👛 a very simple REST API for saving online articles to read later</description>
		<pubDate>2024-01-04 23:13:24.763009482 -0600 CST</pubDate>
		<content:encoded>&lt; ....



Currently the only supported installation method is with Nix Flakes. This flake provides the reticule package and a module for using it declaratively with NixOS. Here is an example flake.nix that you can copy from if your system is configured with Flakes:

  inputs = {
    reticule.url = "git+https://git.cyberia.club/reese/reticule.git";
  outputs = { reticule, ... }@inputs: {
    nixosConfigurations.hostname = nixpkgs.lib.nixosSystem rec {
      modules = [

The possible configuration values can be found here.

From source

You can also download the source code from this repository and build it like any other Go binary. Once built, see ./reticule -h for usage info.


$ go run . -db-path ./reticule-data -address -port 8080 -api-key EXAMPLE  -feed-name test -feed-desc my-test-feed
[INFO] [cloverDB] creating database directory './reticule-data' (/home/forest/Desktop/git/reticule/reticule-data)
[INFO] Starting server on

If you get module errors, try go clean -modcache (Note: this may take a while)


Web browser bookmarklet

Create a new bookmark in your browser with the name "Save to Reticule" and set the URL to the following:


Important: Make sure you change <SERVER_ADDRESS> and <API_KEY> to the values you configured your server with.

Go to a webpage that you want to save, click the bookmarklet, and voila! It should open a new tab with a message that it was saved successfully, which you can then close.


  1. Install HTTP Shortcuts from F-Droid or the Play Store.
  2. Download reticule_http_shortcut.json from this repo to your device.
  3. Open HTTP Shortcuts, tap the vertical 3 dots in the top right corner, tap "Import/Export", then tap "Import from file". Select the json file you downloaded earlier.
  4. Go back to the main page, tap the 3 dot button again, then tap "Variables", and edit the values of reticule_instance and reticule_api_key to match those of your instance.
  5. Try using the share button in an app. A new item "Send to..." with the HTTP Shortcuts icon should appear on the share sheet. You can also save an article by tapping the shortcut inside the HTTP Shortcuts app itself and pasting the URL.

RSS feed reader

The RSS feed is available at /feed?key=<API_KEY>. Add your key, or remove everything after ? if you set public to true, and then add it to your feed reader of choice. If it doesn't work in your reader, open an issue and I will try my best to resolve it!


The purple coin purse favicon comes from OpenMoji, which is licensed under CC BY-SA 4.0.