Skip to content

clamsfeel2/nitchplusplus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

62 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nitch++-image

nitch++

A rewrite of nitch in C++ with some extra features.

Currently takes 2 milliseconds to run on my machine.

Why?

Because nitch has been unmaintained since 2022 and I think it was a neat project.

Support

nitch++ currently supports the following Linux distributions, although I have not been able to test all of them. If any problems arise, please create an issue.

  • Ubuntu
  • Arch
  • EndeavourOS
  • Artix
  • Manjaro
  • Debian
  • Fedora
  • RedHat
  • Mint
  • PopOS!
  • Void
  • OpenSUSE
  • Gentoo
  • NixOS
  • Zorin
  • Slackware
  • CentOS

Dependencies

Note

Having a NerdFont installed on your system is required to make the icons display.

nitch++ relies on g++, cmake, and either ninja or make for compiling and building.

Building and Installation

For those on Arch based systems, I have a PKGBUILD available.

For everyone else:

Clone the repository and go into the new directory

git clone https://github.com/clamsfeel2/nitchplusplus.git && cd nitchplusplus

Create and cd into the build directory

mkdir build && cd build

Run CMake, then build the project

cmake .. && make install

or with ninja

cmake -GNinja .. && ninja install

To uninstall nitch++ run

make uninstall

or with ninja

ninja uninstall

Usage

Just run

nitch++

To not display ascii art

nitch++ --noascii

To display ascii art of a different distro

nitch++ --distro [distro name]

A list of valid distro names can be found in the example config file

To clear the screen before nitch++ is ran

nitch++ --clear

Adjust the box width in the output

nitch++ --width [integer >= 5]

Padding adjustment for each row/column is not currently supported, making this feature more of a gimmick for now. Still fun, I think.

Configuration

In order to use the config file, put the example config file into the config directory. By default nitch++ will use $HOME/.config/nitch++/config.toml as the path to your config file. However, you are able to change the path by setting NITCHPP_CONFIG_FILE environment variable to a path ending in config.toml