Freedom251 › Reference Management Software

Pramaana

Paid LinuxMacWindows

What Pramaana is

Pramaana is a free, open-source reference manager for people who want to handle bibliographies and files from the command line. It stores references in BibTeX and arranges them in nested folders with PDFs and other attachments. Commands cover creating references from URLs or templates, editing, searching, listing, showing, opening, importing, exporting, and moving, copying, linking, or removing files. New attachments can come from a specified path or the Downloads folder; attachment operations support copying, moving, and hardlinking, with hardlinks as the default.

For imports, Pramaana accepts a specially configured BetterBibTeX export from Zotero, including attachment and collection fields. URL-based imports require a running Zotero Translation Server. Exports can be set up with source patterns and a destination BibTeX file. Configuration includes the storage path, attachment behavior, translation server address, export settings, and reference templates. The recommended installation route is pipx, which places it in an isolated environment and makes the command available globally. It supports Linux, macOS, and Windows, requires Python 3.8 or newer, and is licensed under MIT. The README identifies Zotero import and translation-server behavior as areas still needing work.

Who it suits

Pramaana suits researchers and other users who prefer managing references, folders, and PDFs through terminal commands or file-manager operations rather than extensive point-and-click work. It is also relevant to Zotero users who can provide a specially configured BetterBibTeX export.

What it does well

Free and open source under the MIT license
Works on Linux, macOS, and Windows
Organizes references and attachments in nested folders
Supports reference creation from URLs or templates
Offers configurable exports to a destination BibTeX file

What to know first

BibTeX is the only supported storage format
URL imports require a running Zotero Translation Server
The README flags Zotero import and server behavior as unfinished

Limits

BibTeX is the only supported storage format. URL-based imports require a running Zotero Translation Server, and the README says Zotero import and Translation Server behavior still need work.

Getting started

Install Pramaana with the recommended pipx method.
Use a Linux, macOS, or Windows environment with Python 3.8 or newer.
Configure the storage path, attachment behavior, templates, and any Translation Server address.
Set up shell completion for bash or zsh if desired.
Import Zotero data with a specially configured BetterBibTeX export, or create references from URLs or templates.

Verdict

Choose Pramaana if you want BibTeX references and their attachments managed through terminal and file-manager workflows. Look elsewhere if you need another storage format or depend on URL importing without a Translation Server.

Questions

How much does Pramaana cost?

It is free and open source.

Which platforms does it support?

Linux, macOS, and Windows.

Can it import a Zotero library?

It can import a specially configured BetterBibTeX export, including attachment and collection fields.

Does it import references from URLs?

Yes, but URL-based imports require a running Zotero Translation Server.

What storage format does it use?

BibTeX is the only supported storage format in the documented configuration.

How is it licensed and installed?

The package lists an MIT license. The recommended installation method is pipx.

Facts from Pramaana's own pages

Customization: Users can configure the storage path, attachment behavior, translation server address, exports, and reference templates. · github.com, 4 Oct 2026
Development status: The README lists Zotero import and Translation Server behavior among items that still need work. · github.com, 11 Oct 2026
Exports: Users can configure BibTeX exports with include and exclude patterns, and exports run automatically after several reference operations. · github.com, 11 Oct 2026
File handling: Attachments can be copied, moved, or hardlinked, and the import default is hardlinking. · github.com, 4 Oct 2026
Installation: The maker recommends installing Pramaana with pipx, which makes the pramaana command available globally in an isolated environment. · github.com, 11 Oct 2026
Integrations: URL-based imports require a running Zotero Translation Server, and Zotero libraries can be imported using a specially configured BetterBibTeX export. · github.com, 11 Oct 2026
Intended user: The maker describes it for users who prefer managing references, folders, and PDFs through terminal or file-manager operations instead of extensive point-and-click use in Zotero. · github.com, 11 Oct 2026
Known limitation: The maker says the published Zotero Translation Server module does not work as well as the one Zotero itself uses. · github.com, 11 Oct 2026
Organization: References and attachments can be organized in nested folders that users can move or edit with command-line and file-manager tools. · github.com, 11 Oct 2026
Purpose: Pramaana is a minimalist command-line reference manager that works with BibTeX files and the Zotero Translation Server. · github.com, 11 Oct 2026
Reference creation: It can create references from URLs or templates and attach files from a specified path or the Downloads folder. · github.com, 11 Oct 2026
Reference operations: Commands include creating and editing references, searching, exporting, importing, and moving or copying files. · github.com, 4 Oct 2026
Reference organization: It organizes references into nested folders alongside their PDFs and other files. · github.com, 4 Oct 2026
Requirements: The package metadata requires Python 3.8 or newer and lists an MIT license. · github.com, 11 Oct 2026
Search and commands: Commands include listing, finding, grepping, showing, opening, moving, copying, linking, and removing references. · github.com, 11 Oct 2026
Shell support: The README documents command, path, export, and template completions for bash and zsh. · github.com, 11 Oct 2026
Storage limit: BibTeX is the only supported storage format in the documented configuration. · github.com, 4 Oct 2026
URL imports: URL-based reference imports require the Zotero Translation Server to be running. · github.com, 4 Oct 2026
Zotero integration: It can import a specially configured BetterBibTeX export from Zotero, including attachment and collection fields. · github.com, 4 Oct 2026

Where Pramaana stands on Freedom251

Reference Management Software#26 of 26