~nixgoat/vento

a CLI inventory for your files

builds.sr.ht via public-inbox

24 days ago
24 days ago

Vento

Latest version Downloads Licensed under GPLv3

Vento is a utility which allows you to manage your files as if you're playing an old text adventure. It's made in Rust and originally inspired by Chesapeake's Inventory.

asciicast

#Installation

Make sure Rust is installed, along with cargo, Rust's package manager.

$ cargo install vento

#2) Manually

Clone the repository using git.

$ git clone https://git.sr.ht/~nixgoat/vento && cd vento

Check out to the latest stable release.

$ git checkout v1.3

#2.a) cargo-make

This install method additionally installs the manpages for Vento. Make sure Rust, cargo and cargo-make are installed.

$ cargo make install

#2.b) Cargo

Make sure Rust is installed, along with cargo, Rust's package manager.

$ cargo install --path .

#Quick Start

After installing, run:

$ vento -i

This will create a .vento folder in your home directory, which will store your inventories. Some basic commands include:

// listing files in the currently active inventory
$ vento

// switching inventory slots
$ vento -c

// undoing last action
$ vento -u

// taking a file or directory
$ take <file|directory>

// dropping a file or directory
$ drop <file|directory> [destination]

For additional documentation, you can check the documentation for each command by running the following.

$ (command) -h

Or, if Vento was installed through cargo-make, check the manpages by running:

$ man (command)

#Credits

  • Chesapeake for the original concept
  • jo! for helping me with Rust concepts!