Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Ruturajn/fetchit
A system fetch tool for Linux, written in Rust.
https://github.com/Ruturajn/fetchit
cli commandline rust
Last synced: 2 months ago
JSON representation
A system fetch tool for Linux, written in Rust.
- Host: GitHub
- URL: https://github.com/Ruturajn/fetchit
- Owner: Ruturajn
- License: gpl-3.0
- Created: 2022-08-18T19:15:14.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-11T22:05:53.000Z (5 months ago)
- Last Synced: 2024-07-18T04:33:49.958Z (3 months ago)
- Topics: cli, commandline, rust
- Language: Rust
- Homepage:
- Size: 69.3 KB
- Stars: 42
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# fetchit
A system fetch tool for Linux, written in ***Rust***.
`fetchit` is a simple system info tool, written in *Rust*, for Linux based operating systems. It offers a few customization options, which are demonstrated in the
screenshots below,
- You can change the colors for the ***top*** and ***bottom*** part of the ascii art, as well as the color for the ***bounding box***.
- The path to a custom ascii text file can be passed to `fetchit` using the `-f` option.
For a custom ascii text file, it is recommended that the ascii art should be contained in a box of `10x28`, i.e. `28` ***spaces*** wide, and `10` ***lines***
in height. If this condition is not met (especially, the height, which should be greater than or equal to `9`, i.e. the number of lines) then `fetchit` will fall back to the default ascii asrt. See [`Usage`](https://github.com/Ruturajn/fetchit#usage) for more details.
## Examples
## Installation
You can install `fetchit` using any of the following methods,
### Arch Linux
`fetchit` is available in the AUR. If you have an AUR helper (for example [paru](https://github.com/Morganamilo/paru)),
```
$ paru -S fetchit-git
```
Or alternatively,
```
# Clone the AUR Package.
$ git clone https://aur.archlinux.org/fetchit-git.git
# Change directory into the repo.
$ cd fetchit-git
# Install it, using `makepkg`.
$ makepkg -si
```
### Install from Releases
Head over to [Releases](https://github.com/Ruturajn/fetchit/releases) to grab a binary for `fetchit`. Once downloaded,
```
# Navigate to the directory where you have downloaded the tar file.
$ tar -xvf fetchit-0.1.1-x86_64.tar.gz
# Copy the executable to `~/.local/bin/`, and if this directory doesn't exist create it.
$ if [[ ! -d ~/.local/bin ]] ; then mkdir -p ~/.local/bin/ ; fi
$ cp ./fetchit ~/.local/bin/
```
Finally, make sure, you add `~/.local/bin/` to `PATH`, if you haven't already.
### Building from Source
```
# First of all install Rust, see "https://www.rust-lang.org/tools/install".
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Clone the git repo.
$ git clone https://github.com/Ruturajn/fetchit.git
# Change directory into the repo.
$ cd ./fetchit
# Build the package.
$ cargo build --release
# Create ~/.cargo/bin/ if it does not exist.
$ if [[ ! -d ~/.cargo/bin ]] ; then mkdir -p ~/.cargo/bin/ ; fi
# Copy the executable to `~/.cargo/bin/`.
$ cp ./target/release/fetchit ~/.cargo/bin/
```
> Note: Please feel free to open ***Issues*** and ***Pull requests***, if you feel something is out of order, or if you are facing any problems.
## Usage
```
fetchit 0.1.1
Ruturajn
A System fetch tool for Linux written in Rust
USAGE:
fetchit [OPTIONS]
OPTIONS:
-b, --bottom-color
Color for the bottom part of the ascii art : black, red, yellow, blue, magenta, cyan,
white, green
-f, --file-path
File path for the ascii text file
-h, --help
Print help information
-o, --outer-box-color
Color for the box : black, red, yellow, blue, magenta, cyan, white, green
-t, --top-color
Color for the top part of the ascii art : black, red, yellow, blue, magenta, cyan,
white, green
-V, --version
Print version information
```
## References
- https://github.com/anhsirk0/fetch-master-6000