/armaria

Armaria is a fast, open, and local first bookmarks manager

Primary LanguageGoMIT LicenseMIT

Armaria

Armaria are a kind of closed, labeled cupboards that were used for book storage in ancient times up till the middle ages.

Armaria is a new way to manage your bookmarks.

As it stands bookmarks are stored either in the cloud, in browser specific formats, or both. It doesn't have to be this way. Armaria stores bookmarks in a SQLite database. This means your bookmarks are local and stored in a single file. They can then be accessed with a myriad of clients including browsers.

You can sync this file across your devices how you would sync any other file. This allows you to share your bookmarks across many different devices and browsers without having to rely on a web service for something as simple as your bookmarks.

Caution

This software is still in progress and should be considered pre-alpha

Supported Platforms

Linux x64 Windows x64 MacOS x64/arm64
Snapcraft Yes No No
Nix Yes No No
Winget No Yes No
Homebrew No No Yes

Features

The features for Armaria are similar to other bookmark implementations:

  • URL, Name, and Description fields
  • Nested folder structure
  • Tags
  • Full text search
  • Manual ordering

Clients

This repository contains the core Armaria library as well as the following clients:

  • CLI: A CLI that is used to manage your bookmarks database from the command line.
  • TUI: A TUI that is used to manage your bookmarks (hosted in the CLI at armaria tui).
  • Native Messaging Host: A native messaging host to enable browsers to interact with your bookmarks database.

Getting Started

You can find the installation instructions for your platform here.

Linux - Snap

You can install Armaria with Snap on Linux:

snap install armaria

Linux - Nix

You can also install Armaria with Nix on Linux.

The package can be found on NUR here.

Directions for adding NUR to your Nix setup can be found here.

MacOS

You can install Armaria with Homebrew on MacOS:

brew install JonathanHope/homebrew-armaria/armaria

Windows

You can install Armaria with WinGet:

winget install Armaria

Browser Extensions

Armaria has a browser extension. You can read about it here.

Roadmap

This software is still in its early days. This roadmap lays out where it currently is, and where it's going. If there is something that you think should be on it that is not please open an issue.

Platform Support:

  • Windows x64
  • Linux x64
  • MacOS x64
  • MacOS arm64

Distribution:

  • Snap
  • Homebrew
  • Winget
  • Nix

Library:

  • Add bookmark
  • Add folder
  • Delete bookmark
  • Delete folder
  • Update bookmark
  • Update folder
  • Add tag
  • Remove tag
  • List bookmarks/folders
  • Install manifest
  • Config file
  • Import bookmarks from exported files

Native Messaging Host:

  • Add bookmark
  • Add folder
  • Delete bookmark
  • Delete folder
  • Update bookmark
  • Update folder
  • Add tag
  • Remove tag
  • List bookmarks/folders

TUI:

  • Add bookmark
  • Add folder
  • Delete bookmark
  • Delete folder
  • Update bookmark (description not done yet)
  • Update folder
  • Add tag
  • Remove tag
  • List bookmarks/folders
  • View bookmark