Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fetchcord/FetchCord
FetchCord grabs your OS info and displays it as Discord Rich Presence
https://github.com/fetchcord/FetchCord
detection discord discordapp distros fetchcord-grabs linux macos macosx python3 rich-presence
Last synced: 6 days ago
JSON representation
FetchCord grabs your OS info and displays it as Discord Rich Presence
- Host: GitHub
- URL: https://github.com/fetchcord/FetchCord
- Owner: fetchcord
- License: mit
- Created: 2020-08-05T07:32:41.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-07T22:30:42.000Z (6 months ago)
- Last Synced: 2024-10-16T17:38:31.793Z (28 days ago)
- Topics: detection, discord, discordapp, distros, fetchcord-grabs, linux, macos, macosx, python3, rich-presence
- Language: Python
- Homepage:
- Size: 1.54 MB
- Stars: 324
- Watchers: 12
- Forks: 19
- Open Issues: 71
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
FetchCord
# Table of content
- [**Features**](#features)
- [**To-Do**](#to-do)
+ **Installing**
- [Install on (gnu/)linux](#installing-on-gnulinux)
- [Install on MacOS](#installing-on-macos)
- [Install on Windows](#installing-on-windows)
+ **Running**
- [Running on (gnu/)linux](#run)
- [Running on MacOS](#run-1)
- [Running on Windows](#run-2)
- [**Configuration**](#Configuration)
- [**Arguments**](#arguments)
- [**Website**](#website)
+ [**Examples**](#examples)
### Features
- [x] Distribution detection
- [x] Distribution Version
- [x] Package detection
- [x] Kernel Detection
- [x] Uptime
- [x] Detecting Window Manager/Desktop Environment
- [x] Detecting GPU/CPU and display it in a cycle (thanks to Hyper-KVM)
- [x] Flatpak support
- [x] Add Snap support
- [x] Add Windows support.
- [x] Detect Window Manager/Desktop Environment version
- [x] Periodic polling of info such as package count, RAM usage, etc.
### To-Do
- [ ] Add more distributions (If your distro is not supported open an issue)
- [ ] Add support for desktop icon use
- [ ] More CPUs, ex. Pentium, Older AMD CPUs
- [ ] More GPUs?
## Installing on (GNU/)Linux
NOTE: you need neofetch to be also installed for this to work.
#### Via AUR
On Arch Linux for the git testing version (the less stable version): [fetchcord-testing](https://aur.archlinux.org/packages/fetchcord-testing/)
And the git version (synced with master): [fetchcord](https://aur.archlinux.org/packages/fetchcord/)
Historically the stabler release was the one from [pip](#via-pip) but now master will have only the stable releases.
#### Via Snap
On systems with snap installed, you can run `sudo snap install fetchcord --classic` to install fetchcord.
Note that like the AUR version, this version is directly from master, for the stable release use [pip](#via-pip)
#### Via pip
To Install fetchcord via pip you can run `pip3 install fetchcord`
If you want to remove FetchCord you can run `pip3 uninstall fetchcord`
### Run
Once installed, simply run `fetchcord`. The program is also daemonizable meaning you can start it on boot using any method you prefer.
If you get `fetchcord: command not found`,add `export PATH="$HOME/.local/bin:$PATH"` to your bashrc, or just run `python3 -m fetchcord`.
Optionally for systemd users there is a user-side `fetchcord.service` in this repo that can be installed to `~/.local/share/systemd/user/`, started and enabled on boot using `systemctl --user enable --now fetchcord`.
## Installing on MacOS
To install FetchCord, run `pip3 install FetchCord`
NOTE: you need neofetch to be also installed for this to work.
### Run
simply run `fetchcord`
## Installing on Windows
To install fetchcord on Windows run `python -m pip install fetchcord neofetch-win`. Alternatively, you can use the neofetch package from scoop as well (show more info at the expense of possible GPU detection, for now).
### Run
To run Fetchcord run `fetchcord`
### Configuration
On Linux you can use the neofetch config file to:
Show disk usage
Battery level
CPU temp
Current CPU speed
Font
Theme
And more
default config path should be `~/.config/neofetch/config.conf`
## Arguments
--nodistro, Don't show distro info.
--nohardware, Don't show hardware info.
--noshell, Don't show shell/terminal info.
--nohost, Don't show host info.
--time, -t, set custom duration for cycles in seconds.
--terminal, set custom terminal (useful if using a script or dmenu).
--termfont, set custom terminal font (useful if neofetch can't get it).
--pause-cycle, Extra cycle that pauses FetchCord to show other activities.
--update, Update database of distros, hardware, etc.
--debug, For debug logs.
--memtype, use GB or MB to show RAM.
-h or --help, shows this information above.
## Website
Fetchcord now has a website! You can find this site over at https://fetchcord.github.io/ - please keep in mind this site is still currently work in progress though.
## Examples
### Operating Systems
  
### Terminals
  
### Cpus
  
### Hosts
  