1
0
Fork 0
mirror of https://git.sr.ht/~nixgoat/vento synced 2024-11-21 14:23:05 +00:00
vento/README.md
Lux Aliaga cba202fd0d manifest: Bump version to v1.3
Goals for this release have been worked on and the software has been
tested enough. Bump the version and update the installation
instructions.
2023-08-28 09:06:15 -04:00

2.1 KiB

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!