hyfetch/README.md
Azalea (on HyDEV-Daisy) d610559b01 [U] Update readme
2022-08-11 14:45:26 -04:00

15 KiB

HyFetch

neofetch with pride flags <3

Running Updated Original Neofetch

This repo also serves as an updated version of the original neofetch since the upstream dylanaraps/neofetch doesn't seem to be maintained anymore (as of Jul 30, 2022, the original repo hasn't merged a pull request for 6 months). If you only want to use the updated neofetch without pride flags, you can use the neofetch script from this repo. To prevent command name conflict, I call it neowofetch :)

  • Method 1: pip install hyfetch then run neowofetch
  • Method 2: npx neowofetch
  • Method 3: bash <(curl -sL neowofetch.hydev.org)

Installation

Install Python >= 3.7 first. Then, just do:

pip install hyfetch

Method 2: Install using system package manager

Currently, these distributions have existing packages for HyFetch:

  • ArchLinux: yay -S hyfetch (Thanks to @ Aleksana)
  • Nix: nix-env -i hyfetch (Thanks to @ YisuiDenghua)
  • Guix: guix install hyfetch (Thanks to @ WammKD)

Usage

When you run hyfetch for the first time, it will prompt you to choose a color system and a preset. Just follow the prompt, and everything should work (hopefully). If something doesn't work, feel free to submit an issue!

If you want to use the updated neofetch without LGBTQ flags, check out this section

Q: How do I change my config?

A: Use hyfetch -c

Q: What do I do if the color is too dark/light for my theme?

A: You can try setting the colors' "lightness" in the configuration menu. The value should be between 0 and 1. For example, if you are using dark theme and the rainbow flag is too dark to display, you can set lightness to 0.7.

Feel free to experiment with it!

image

Change Log

About Notation

Updates to HyFetch begins with the emoji 🌈
Updates to neowofetch begins with the emoji 🖼️

TODO

Unpublished 1.3.1

  • 🌈 Add finsexual flag (#12)
🖼️ Meta Changes
  • Meta - Fixed shellcheck warnings in neowofetch
  • Meta - Moved shellcheck from travis to GitHub Actions
  • Meta - Created a script to automatically generate distro list
🖼️ Distro/OS Support Changes
🖼️ Device Support Changes
🖼️ Bug Fixes

1.3.0

🖼️ Ascii Art Changes
🖼️ Distro/OS Support Changes
🖼️ Device Support Changes
🖼️ Bug Fixes

1.2.0

  • 🚀 Take over neofetch with neowofetch
🖼️ Ascii Art Changes
  • Ascii - Add uwuntu (#9) (use it with hyfetch --test-distro uwuntu or neowofetch --ascii_distro uwuntu)
  • Ascii - Better Void ascii art (#10)
  • Ascii - Update old NixOS logo for compatibility (dylanaraps#2114)
🖼️ Distro/OS Support Changes
🖼️ Device/Program Support Changes
🖼️ Bug Fixes

1.1.3rc1

  • 🌈 Add foreground-background color arrangement to make Fedora and Ubuntu look nicer
  • 🌈 Allow typing abbreviations in flag selection
  • 🌈 Fix: Duplicate random color arrangements are appearing in selection screen
  • 🌈 Fix: Inconsistant color arrangement when saved to config file

1.1.2

  • Add more flags (#5)
  • Removed numpy dependency that was used in 1.1.0

1.1.0

  • Refactored a lot of things
  • Added Beiyang flag xD
  • Added interactive configurator for brightness adjustment
  • Added dark/light mode selection
  • Added color bar preview for RGB/8bit mode selection
  • Added random color arrangement feature (for NixOS)

1.0.7

  • Fix: Make config path not on init but when it's actually needed.

1.0.6

  • Remove hypy_utils dependency to make packaging easier.

1.0.5

  • Fix terminal emulator detection (PR #2)

1.0.4

1.0.3

  • Fix missing dependency for setuptools

1.0.2

  • Implement RGB to 8bit conversion
  • Add support for Python 3.7 and 3.8

1.0.1

  • Included 11 flag presets
  • Ability to lighten colors with --c-set-l <lightness>
  • Command-line flag chooser
  • Supports Python >= 3.9

More Screenshots

image image

Original Readme from Neofetch Below

logo

A command-line system information tool written in bash 3.2+

Packaging status

neofetch

Neofetch is a command-line system information tool written in bash 3.2+. Neofetch displays information about your operating system, software and hardware in an aesthetic and visually pleasing way.

The overall purpose of Neofetch is to be used in screen-shots of your system. Neofetch shows the information other people want to see. There are other tools available for proper system statistic/diagnostics.

The information by default is displayed alongside your operating system's logo. You can further configure Neofetch to instead use an image, a custom ASCII file, your wallpaper or nothing at all.

neofetch

You can further configure Neofetch to display exactly what you want it to. Through the use of command-line flags and the configuration file you can change existing information outputs or add your own custom ones.

Neofetch supports almost 150 different operating systems. From Linux to Windows, all the way to more obscure operating systems like Minix, AIX and Haiku. If your favourite operating system is unsupported: Open up an issue and support will be added.

More: [Dependencies] [Installation] [Wiki]