Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ghfetch/ghfetch
A nice way to display CLI Github user / repo / organization info inspired in neofetch
https://github.com/ghfetch/ghfetch
apt archlinux aur cli neofetch pip python3 script snap tools yay
Last synced: 2 days ago
JSON representation
A nice way to display CLI Github user / repo / organization info inspired in neofetch
- Host: GitHub
- URL: https://github.com/ghfetch/ghfetch
- Owner: ghfetch
- License: mit
- Created: 2023-07-08T15:20:45.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-01T13:48:15.000Z (about 1 month ago)
- Last Synced: 2025-01-02T00:15:08.683Z (3 days ago)
- Topics: apt, archlinux, aur, cli, neofetch, pip, python3, script, snap, tools, yay
- Language: Python
- Homepage:
- Size: 535 KB
- Stars: 11
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ghfetch
> The previous video has as examples the commands:
>
> * `ghfetch ghfetch` - (An organization)
> * `ghfetch icutum` - (A user)
> * `ghfetch nullgaro` - (A user)
> * `ghfetch torvalds/linux` - (A repo)
## Description
A nice way to display CLI user / organization / repo info inspired in [Neofetch](https://github.com/dylanaraps/neofetch)
ghfetch is a CLI information tool written in `Python >= 3.5` that displays info about any user/org/repo you pass as argument.
Upon execution, the script displays on the terminal relevant information, like the profile picture, public repos, stars, followers, etc.
Additionally, in this project, we've used Github Actions to be able to create a new release each time we merge to main, thanks to this, the build for AUR is easier.
## Installation
### Package manager
**apt:**
Firstly you have to add the repository with "add-apt-repository":
```sh
add-apt-repository "deb https://ppa.launchpadcontent.net/ghfetch/ghfetch/ubuntu/ mantic main"
apt-get update
```
If you don't have "add-apt-repository", you can install it with:
```sh
apt-get install software-properties-common python3-launchpadlib
```
> For troubleshooting see [here](https://github.com/ghfetch/ghfetch#troubleshooting-%EF%B8%8F).
And then you can install **ghfetch**
```sh
apt-get install ghfetch
```
**Arch Linux:**
Use your favorite AUR helper, i.e:
```sh
yay -Syu ghfetch
```
**Snap:**
```sh
snap install ghfetch
```
**PIP:**
```sh
pip install --upgrade pip
pip install ghfetch-pip
```
> For troubleshooting see [here](https://github.com/ghfetch/ghfetch#troubleshooting-%EF%B8%8F).
### Manual installation
```sh
git clone https://github.com/ghfetch/ghfetch.git
cd ghfetch
pip install .
```
## Usage
```sh
ghfetch
```
```sh
ghfetch /
```
### Example usage
**User:**
```sh
ghfetch nullgaro
ghfetch icutum
```
**Organization:**
```sh
ghfetch ghfetch
ghfetch confugiradores
```
**Repo:**
```sh
ghfetch torvalds/linux
ghfetch ghfetch/ghfetch
```
## To-do's 📋
### Code 💻
- [ ] Private API key for access to private repositories
### Package upload 📦
- [X] AUR
- [X] Apt
- [X] Pip
- [X] Snap
- [ ] DNF/Yum
- [ ] Brew
- [ ] Windows
- [ ] Zypper
- [ ] DPKG
### Wishlist 🥺
- [ ] Pacman
## Troubleshooting 🛠️
### Warn: `WARNING: The scripts ghfetch-pip is installed in '/home/USERNAME/.local/bin' which is not on PATH.`
If you are installing ghfetch using PIP, and you get a similar warning to this:
The solution is to add `export PATH=/home/user/.local/bin:$PATH` to your .bashrc, where `/home/user/.local/bin` would be the path that the warning is telling you, and reboot.
### Updating ghfetch using yay doesn't update it
This issue happens because the yay's cache is interfering with the update. The solution is to clear the cache of yay with `yay -Sc --aur`.
### When adding the repository to apt gets some pythonic error
This issue happens because `apt-add-repository` is missing `python3-launchpadlib`. The solution is to install it with `apt-get install python3-launchpadlib`.
## People 👨💻
This project was developed with ❤️ by [Nullgaro](https://github.com/nullgaro) and [Icutum](https://github.com/icutum).
[](https://github.com/nullgaro)[](https://github.com/icutum)
## Support ❤️
If you find our ghfetch script helpful and want to contribute to its development and maintenance, consider buying us a coffee! ☕ Your support means a lot!
[](https://bmc.link/ghfetch)