- Python 92.8%
- C++ 3.1%
- C 3.1%
- HTML 0.4%
- XSLT 0.2%
|
Some checks failed
ci/woodpecker/push/push-to-dev Pipeline failed
Reviewed-on: #32 |
||
|---|---|---|
| .github | ||
| .woodpecker | ||
| bypy | ||
| container | ||
| data/arcalibre_data | ||
| format_docs | ||
| icons | ||
| imgsrc | ||
| manual | ||
| resources | ||
| scripts | ||
| setup | ||
| src | ||
| tests | ||
| translations@94d8062f3d | ||
| typeshed/calibre_extensions | ||
| .dockerignore | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| Changelog.old.txt | ||
| Changelog.txt | ||
| codespell.exclude | ||
| COPYRIGHT | ||
| Do.md | ||
| envrc.recommended | ||
| INSTALL.rst | ||
| LICENSE | ||
| LICENSE.rtf | ||
| make.py | ||
| pdm.lock | ||
| pyproject.toml | ||
| README.md | ||
| rsync-and-build.sh | ||
| SECURITY.md | ||
| session.vim | ||
| shell.nix | ||
| update-on-ox | ||
Arcalibre, by the rereading Project
Arcalibre is an AI-free e-book manager, based on Calibre.
It can view, convert, edit and catalog e-books in all of the major e-book formats. It can also talk to e-book reader devices. It can go out to the internet and fetch metadata for your books. It can download newspapers and convert them into e-books for convenient reading.
For more information, see the Arcalibre about page.
Arcalibre is developed and maintained by the rereading Project, dedicated to making AI-free software for writers, readers, and independent publishers. Follow us on the fediverse, Bluesky, or join the community forums.
Current Status
Arcalibre is in a pre-alpha state. Please make sure your entire library is backed up before attempting to use Arcalibre in any way.
Several Calibre features and core functionalities are currently broken:
- Support for fetching news using recipes is currently broken.
- Language and country codes are based on a static snapshot, and are not currently updated as geopolitical situations evolve.
- Localization may not work as expected.
- Features that rely on parsing HTML5 will raise errors.
- Windows and macOS support is currently broken, but this should hopefully change soon.
- If Arcalibre is run from a virtual environment, the
bin/folder for that environment must be on PATH, as Arcalibre runs separate executables such as the e-book viewer and editor using commands located within the virtual environment. We hope to remove this restriction in the future.
Several Calibre features have been intentionally removed, and will not be supported going forward:
- Any and all AI antifeatures.
- Checking for updates; this is deferred to your system's package manager or app store.
- Downloading and running Python modules and recipes at runtime; this opens the possibility for significant security vulnerabilities, significantly increasing maintenance burden. If you're developing recipes, plugins, or store modules for Arcalibre, note that the
calibre.live.load_modulefunction has been removed. - Support for EOL operating systems such as Windows XP will not be maintained.
- Support for EOL versions of Python will not be maintained.
- "Develop mode" has been removed in favor of standard Python "editable packages." Please see your Python package manager's documentation on how to use editable packages.
Additionally, we expect Arcalibre to be buggy in a few respects:
- Backwards compatibility logic for Unicode handling in very old versions of Python has been removed in some places; this may break when dealing with existing databases that use non-Unicode character encodings.
- Spellchecking logic has been ported from Hunspell to Spellbook, which may introduce compatibility issues.
- Python extension modules no longer dynamically link to system Python interpreters when running from within virtual environments; this may break some functionality that assumes the use of a system Python interpreter.
Usage
See the User Manual, coming soon.
Development
See the Development Guide, coming soon.
Check Do.md in this repository for build and development tasks.