An assistant for users of the Johnny Decimal file organization system.
Find a file
renovate-bot 304cff3f27
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
ci/woodpecker/push/clippy Pipeline was successful
ci/woodpecker/push/cross-compile-attempt Pipeline was successful
ci/woodpecker/push/fmt Pipeline was successful
ci/woodpecker/push/test Pipeline was successful
ci/woodpecker/push/doc Pipeline was successful
chore(deps): update dependency rust to v1.96.0
2026-06-04 20:03:06 +00:00
.woodpecker Use mise 2025-08-06 11:36:58 -06:00
dummydecimal Continue name change 2025-05-27 21:32:42 -06:00
src fix: remove expectation that is on by default 2026-04-07 15:45:57 -06:00
.editorconfig Add yaml to editorconfig 2025-05-28 21:42:27 -06:00
.gitignore Create updated .gitignore to distribute with repo 2024-01-08 10:07:26 -05:00
Cargo.lock chore(deps): update rust crate clap to v4.6.1 2026-04-23 12:19:55 +00:00
Cargo.toml Remove serde_yaml and serde_json 2025-05-28 12:08:17 -06:00
CHANGELOG.md Revert "Add name change to changelog" 2025-05-28 10:41:48 -06:00
CODE_OF_CONDUCT.md Write a README, change license, add CoC 2025-05-27 20:52:21 -06:00
LICENSE.md Write a README, change license, add CoC 2025-05-27 20:52:21 -06:00
mise.toml chore(deps): update dependency rust to v1.96.0 2026-06-04 20:03:06 +00:00
README.md fix(docs): update CI badge [ci skip] 2026-05-27 11:27:56 -06:00
release.toml Add changelog, prepare for release 2025-05-27 21:04:00 -06:00
renovate.json Update renovate.json 2026-05-27 16:01:14 +00:00

johnnydecimal-rs

status-badge

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/.