johnnydecimal-rs 2.0.0

An assistant for users of the Johnny Decimal file organization system
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# johnnydecimal-rs

[![status-badge](https://ci.cosmicrose.dev/api/badges/39/status.svg)](https://ci.cosmicrose.dev/repos/39)

An assistant for users of the [Johnny Decimal](https://johnnydecimal.com) file organization system.

## Install

```sh
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.

```console
$ 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](https://cosmicrose.dev).
You can get in touch with her on [Matrix](https://matrix.to/#/@cosmicrose:matrix.org).

## Thanks

This project was forked from [`SwissArmyWrench/johnnybgoode`](https://github.com/SwissArmyWrench/johnnybgoode)
and I am thankful to build from that foundation.

## Contributing

Questions and [pull requests](https://codeberg.org/cosmicrose/johnnydecimal-rs/pulls) are
more than welcome.
I follow believe bad documentation is a bug, so if anything is unclear, please
[file an issue](https://codeberg.org/cosmicrose/johnnydecimal-rs/issues/new)!

Note that this project is released with a [Code of Conduct](CODE_OF_CONDUCT.md).
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](LICENSE.md) 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/>.