ADSfolio
A desktop app and Python toolkit that organizes your research PDFs with NASA ADS / SciXplorer, Crossref, and DataCite metadata. ADSfolio is an independent project, not an official ADS application.
ADSfolio uses the official NASA ADS API for searches, citation exports, metrics, ADS libraries, and journal information. We thank the ADS team for providing these services and their API documentation.
Install
- Desktop app: download the file for your system from the latest release.
- Homebrew on macOS:
brew install --cask ysBach/adsfolio/adsfolio - CLI and Python API:
pip install adsfolio. This installation omits Qt and the desktop bundle. Useuv tool install adsfoliofor an isolated CLI. - Python with desktop features:
pip install "adsfolio[full,gui]".
For AI agents, download the brief
CLI/API skill.
Save it as adsfolio-cli-api/SKILL.md in your agent's skills directory.
The source skill is also available in this repository.
Search supports structured output:
adsfolio search 'author:Einstein' --fields bibcode,title,year --rows 5 --json
ADS searches require an ADS token. See CLI and Python for setup and API examples.
The app is not signed. Your system can ask you to approve it the first time. See Getting started for the steps.
Daily workflows
- Keep a BibTeX file for your paper: export an ADS library as
.bibfor LaTeX or Overleaf. - Watch a folder: ADSfolio identifies each new PDF and renames it when the PDF's own arXiv ID or DOI confirms the match.
- Keep Identify defaults: save ADS fallback and provider choices for all libraries or one library.
- Make your CV: write your publication list in LaTeX, HTML, Markdown, or your own format.
- Find a paper fast: type
author:bach year:2019, or plain words. A list suggests fields and author names, and the table highlights the matches.
See the daily workflows with screenshots and a video.
Documentation
License
BSD-3-Clause. The desktop bundles include third-party components under their own licenses. PyMuPDF uses AGPL terms. See Building the desktop app for details.
1 maintainer
Metadata
1 maintainer
Release files for adsfolio 0.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| adsfolio-0.9.0.tar.gz | 1.2 MB | Without provenance | Details for adsfolio-0.9.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| adsfolio-0.9.0-py3-none-any.whl | Python 3 | none | any | Details for adsfolio-0.9.0-py3-none-any.whl |
Total release size: 2.1 MB
Release files / adsfolio-0.9.0.tar.gz
| Download URL | adsfolio-0.9.0.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1bb913ebe017b259dfb077fd7deba083bb24b0ae15abff18ce188d4a5d065ad5
|
|
BLAKE2b-256 checksum How to use checksums |
026f8f7ea753efeb1661c2fee5f4fbf5e35f22be5204bf5867ea647748f910a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / adsfolio-0.9.0-py3-none-any.whl
| Download URL | adsfolio-0.9.0-py3-none-any.whl |
|---|---|
| Size | 861.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d72bdf10c5a296b3754b177832fa5539c54159f6eff78aa95b6b0fdf1c3081e4
|
|
BLAKE2b-256 checksum How to use checksums |
5aebeaee1c9fac1e8e45f63af5a19a5456483c973c71f801890f42fa0acb171a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for adsfolio 0.9.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
