johnnydecimal-rs

An assistant for users of the Johnny Decimal file organization system.

Install

git clone https://codeberg.org/cosmicrose/johnnydecimal-rs.git
cd johnnydecimal-rs
cargo install --path .

Usage

Use johnny path <ID> to get the absolute path of the folder with that ID. You must give the path to your system's root folder as --home, or set it to the JOHNNYDECIMAL_HOME environment variable.

$ johnny --home ~/Documents path 11.83
/home/user/Documents/10-19 Life admin/11 Me & other living things/11.83 My library

See johnny --help for more information.

Maintainer

This project is maintained by Rosa Richter. You can get in touch with her on Matrix.

Thanks

This project was forked from SwissArmyWrench/johnnybgoode and I am thankful to build from that foundation.

Contributing

Questions and pull requests are more than welcome. I follow believe bad documentation is a bug, so if anything is unclear, please file an issue!

Note that this project is released with a Code of Conduct. By participating in this project you agree to abide by its terms.

License

© 2025 Rosa Richter

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.