Mercurial > topfetch++

comparison README @ 2:4034cee64a58

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
add stuff
author Yasuri <yasuri@charliesmp.net>
date Sun, 04 Oct 2026 14:33:37 -0500
parents
children
comparison
equal deleted inserted replaced
1:841975e638f2 2:4034cee64a58
1 topfetch++
2 ==========
3
4 A tiny live system monitor and fetch tool for Linux, written in C++.
5
6 It combines fastfetch and btop in one small program: a distro logo and
7 system info that refresh every second, with live CPU, memory, and uptime.
8
9
10 FEATURES
11
12 - Distro logo next to your system info (NixOS, Arch, Gentoo, plus a
13 generic fallback)
14 - Live-updating CPU usage, memory, and uptime
15 - Picks the logo from /etc/os-release, and derivatives work through
16 ID_LIKE (Manjaro gets the Arch logo, for example)
17 - No dependencies beyond the C++ standard library
18 - Reads /proc and /etc/os-release directly, so the code is short and
19 easy to follow
20
21
22 BUILD
23
24 g++ -std=c++17 main.cpp -o topfetch
25
26
27 USAGE
28
29 ./topfetch
30 ./topfetch --logo arch
31
32 --logo overrides the detected distro. Available logos: nixos, arch,
33 gentoo. Unknown distros get a generic Tux. Stop it with Ctrl+C.
34
35
36 PLATFORM
37
38 Linux only. It relies on /proc and /etc/os-release.
39
40
41 ADDING A LOGO
42
43 Add an entry to the map in pickLogo in main.cpp. The key is the ID=
44 value from /etc/os-release. Each entry holds the art lines and an ANSI
45 color code.
46
47
48 SOURCE
49
50 Development happens in Mercurial at https://hg.charliesmp.net/topfetch++.
51 Send patches to Yasuri <yasuri@charliesmp.net>.
52 This repository is a mirror.
53
54
55 LICENSE
56
57 topfetch++ is licensed under the ISC license. See the LICENSE file.
58
59 The ASCII art logos are adapted from pfetch (MIT):
60 Copyright (c) 2016-2021 Dylan Araps
61 Copyright (c) 2024-2025 Joey Reinhart
62 See the THIRD-PARTY-NOTICES file for the full license text.