Download the PHP package indemnity83/book-tools without Composer
On this page you can find all versions of the php package indemnity83/book-tools. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download indemnity83/book-tools
More information about indemnity83/book-tools
Files in indemnity83/book-tools
Package book-tools
Short Description Librarian CLI: A simple tool to organize and shelve audiobooks from import folders into a structured library.
License MIT
Homepage https://github.com/indemnity83/book-tools
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package book-tools
📚 Book Tools (librarian CLI)
A simple command-line tool for managing audiobook files and organizing them into a clean, structured library.
Perfect for post-processing audiobooks prepared via AudioBookShelf or similar apps.
Command name:
librarian
Folder / repo name:book-tools
Current available command:shelve
🚀 Commands
shelve
Organizes and moves books from an import directory into a structured destination library.
`
Arguments
| Argument | Description |
|---|---|
importFolder |
(Required) Path to the import folder. This folder should contain subfolders for each book with metadata and files. |
destinationFolder |
(Optional) Path to the destination library root. Defaults to the current working directory if not provided. |
Options
| Option | Description |
|---|---|
--dry-run |
Shows what would be done without making any changes. |
--pretend |
Alias for --dry-run. |
📦 How it works
The shelve command will:
- Scan the
importFolderfor book subfolders. - Each book folder must contain a
metadata.jsonfile (produced by AudioBookShelf). - Files will be moved into:
- If no series → simpler path without series folder.
- If multiple audio files → filenames will include
Part 1,Part 2, etc.
-
After processing:
- If in
--dry-run→ no files will be moved, only output shown. - If real mode → files are moved, extra files (cover, metadata) copied, and original import folder removed if empty.
- If in
✅ Example
Will scan _import folder and move books to the main audiobooks library, cleaning up the import folder after.
Will show exactly what would happen, but not move anything.
📚 Future roadmap
This is version 1 (MVP) with only the shelve command.
Future tools planned may include:
scan→ check library for missing metadatarename→ force renaming of existing library to match patternscleanup→ remove orphaned or duplicate files
🧹 Development and testing
Feature and unit tests are provided using PestPHP. To run tests:
You can also test the CLI directly:
👷♂️ Contributors
Currently maintained by indemnity83. Pull requests welcome as the tool expands!
📜 License
MIT — do what you want, but please don’t sell it without adding value.
All versions of book-tools with dependencies
laravel-zero/framework Version ^11.36.1
laravel-zero/phar-updater Version ^1.4