rstoner (2.0.0)
Installation
[registries.forgejo]
index = "sparse+cargo add rstoner@2.0.0 --registry forgejoAbout this package
rstoner
A CLI tool for generating metadata tagging commands for audiobooks.
Overview
rstoner generates shell commands for the tone audiobook metadata tagging tool and the m4b-tool for creating M4B audiobook files.
It processes audiobook directories and outputs ready-to-run commands that can be executed manually, saved to a script, or run directly from the built-in interactive TUI.
Installation
From Releases (Recommended)
Download the latest static binary from the releases page:
# Download the binary
curl -fsSL "https://git.desord.re/eofredj/rstoner/releases/download/v0.7.0/rstoner-x86_64" -o rstoner
# Verify checksum
sha256sum -c rstoner-x86_64.sha256
# Make executable and move to PATH
chmod +x rstoner
mv rstoner /usr/local/bin/rstoner
From crates.io
cargo install rstoner
Build from Source
git clone https://git.desord.re/eofredj/rstoner.git
cd rstoner
cargo build --release
See CONTRIBUTING.md for static musl builds and other build variants.
Quick Start
rstoner -a "Author Name" -n "Narrator Name" /path/to/audiobook
Run in a terminal to get the interactive TUI, or pipe/redirect output to get plain shell commands. Full CLI options, examples, generated output, and directory layout requirements are in the Usage Guide.
Requirements
Run rstoner --check to verify both are installed.
Documentation
| Document | Purpose |
|---|---|
| Usage Guide | Full CLI options, examples, configuration file, and TUI |
| Architecture Overview | System design, data flow, and module structure |
| CONTRIBUTING.md | Development setup, style guide, testing, and release process |
| Security Considerations | Shell escaping and the security model |
Security
All user-provided values are shell-escaped to prevent command injection. See Security Considerations for the full model, and SECURITY.md to report a vulnerability.
Contributing
See CONTRIBUTING.md for development setup, style guide, and the contribution workflow. Participation in this project is governed by the Code of Conduct.
License
GPL-3.0-or-later. See LICENSE for the full text.
Dependencies
| ID | Version |
|---|---|
| clap | ^4.6.6 |
| colored | ^3.1.1 |
| crossterm | ^0.29 |
| dirs | ^6.0.0 |
| ratatui | ^0.30.2 |
| regex | ^1.13.1 |
| serde | ^1.0.229 |
| serde_json | ^1.0.151 |
| shell-escape | ^0.1 |
| thiserror | ^2.0.20 |
| toml | ^1.1.2 |
| which | ^8.0.5 |
| insta | ^1.42 |
| tempfile | ^3.27.0 |