Skip to content

Repository files navigation

Analecta

Latin (a.naˈlɛk.ta), masculine noun I declension, from the Ancient Greek ἀνάλεκτα (analékta). Selected fragments, a curated collection of writings.

Save web content as clean Markdown. Read, annotate and connect. Entirely locally.

Made in Linux for Linux.

CI GitHub release License: MIT

Analecta

Analecta is a local Linux desktop application that turns any URL — article, YouTube video, Substack post, X/Twitter thread — into a clean Markdown file stored in your personal vault. No cloud sync, no subscription, no tracking. Truly private and yours.

Features

  • Web extraction — paste a URL (Ctrl+L) to extract the main content as clean Markdown. Supports articles, YouTube transcripts, Substack posts, X/Twitter threads, and more.
  • Native Markdown reading view — every entry renders as clean, formatted Markdown.
  • Local vault — every entry is saved as a Markdown file in a directory you control, compatible with other PKM tools.
  • Reading library — organize entries by status: Unread, Read, Bookmark, Gem, Archive.
  • Full-text search — fast search across titles and content (Ctrl+K), powered by SQLite FTS5.
  • Tags & backlinks — tag list, automatic bidirectional Linked Mentions, clickable [[wikilink]] rendering, and clickable #hashtag navigation to the TAGS dashboard across your vault. Tags and hashtags accept Spanish-accented letters and symbols, with case-insensitive but accent-sensitive identity (cafécafe).
  • Connections — manually link related entries via a search-to-connect dialog.
  • Knowledge graph — interactive vault-wide graph, built with Sigma.js, and per-entry subgraph.
  • Markdown editor — built-in editor with CodeMirror 6 and Tokyo Night theme.
  • Multi-tab reading — open multiple entries in tabs; scroll positions are preserved across sessions.
  • Auto-updates — new releases are delivered automatically via the in-app updater.

Screenshots

Library dashboard COLLECTA dashboard Reading view TAGS dashboard

Download

Download for Linux from the Releases page. See CHANGELOG.md for what's new in each version.

Format Recommended for
.deb Debian, Ubuntu, Pop!_OS, Linux Mint
.rpm Fedora, openSUSE, RHEL
.AppImage Any Linux distribution

Requirements: Linux x86_64, Wayland or X11.

GNOME users: the system tray requires the AppIndicator and KStatusNotifierItem Support GNOME Shell extension. KDE, i3, and Sway work out of the box.

Build from source

See CONTRIBUTING.md for environment setup, build instructions, and contribution guidelines.

Architecture

Analecta is a hybrid desktop application: an Electron shell manages the window and native OS integration; a bundled Python sidecar (FastAPI + uvicorn, packaged with PyInstaller) handles web extraction and local storage via SQLite; a SvelteKit frontend runs in the renderer process. All communication between frontend and sidecar goes over HTTP on a dynamic loopback port — no data leaves the machine.

Tech Stack

Beyond the shell/sidecar/frontend split described in Architecture:

  • Extraction — trafilatura and readability-lxml for content extraction, markdownify for HTML-to-Markdown conversion, youtube-transcript-api for transcripts, X's own syndication endpoint (with an oEmbed fallback) for tweets.
  • Reading & editing — markdown-it for the native reading view, Shiki for syntax-highlighted code blocks, CodeMirror 6 for the built-in editor.
  • Knowledge graph — Sigma.js and graphology for the vault-wide graph, d3-force for the per-entry subgraph.
  • Search — SQLite FTS5.
  • Distribution — electron-builder and electron-updater.

Security

To report a vulnerability, see SECURITY.md.

For the network identity Analecta presents when fetching a URL — what it sends, what it doesn't, and how that compares to browsing the same page in a browser — see docs/privacy.md.

License

MIT — see LICENSE.

About

A read-it-later app for Linux that runs entirely on your machine. Web articles, YouTube, Substack & X threads become clean Markdown in your PKM vault. No cloud, no tracking.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages