1
2[![Logo](https://github.com/X0rg/CPU-X/blob/master/data/icons/CPU-X_22x22.png?raw=true)](https://x0rg.github.io/CPU-X/)
3[![GitHub release](https://img.shields.io/github/release/X0rg/CPU-X.svg)](https://github.com/X0rg/CPU-X/tags)
4[![GitHub commits](https://img.shields.io/github/commits-since/X0rg/CPU-X/latest.svg)](https://github.com/X0rg/CPU-X/commits/master)
5[![GitHub downloads](https://img.shields.io/github/downloads/X0rg/CPU-X/latest/total.svg)](https://github.com/X0rg/CPU-X/releases/latest)
6[![GitHub total downloads](https://img.shields.io/github/downloads/X0rg/CPU-X/total.svg)](https://github.com/X0rg/CPU-X/releases)
7[![GitHub issues](https://img.shields.io/github/issues/X0rg/CPU-X.svg)](https://github.com/X0rg/CPU-X/issues)
8[![GitHub pull-requests](https://img.shields.io/github/issues-pr/X0rg/CPU-X.svg)](https://GitHub.com/X0rg/CPU-X/pull)
9[![Translation status](https://hosted.weblate.org/widgets/cpu-x/-/svg-badge.svg)](https://hosted.weblate.org/engage/cpu-x/?utm_source=widget)
10
11| Linux | FreeBSD | AppImage |
12| :---: | :---: | :---: |
13| [![Build Status (Linux)](https://travis-ci.com/X0rg/CPU-X.svg?branch=master)](https://travis-ci.com/github/X0rg/CPU-X) | [![Build Status (FreeBSD)](https://api.cirrus-ci.com/github/X0rg/CPU-X.svg)](https://cirrus-ci.com/github/X0rg/CPU-X) | [![AppImage Continuous](https://github.com/X0rg/CPU-X/workflows/AppImage%20Continuous/badge.svg?branch=master)](https://github.com/X0rg/CPU-X/actions?query=workflow%3A%22AppImage+Continuous%22) |
14
15**CPU-X** is a Free software that gathers information on CPU, motherboard and more.
16CPU-X is similar to [CPU-Z (Windows)](https://www.cpuid.com/softwares/cpu-z.html), but CPU-X is a Free and Open Source software designed for GNU/Linux and FreeBSD.
17This software is written in C and built with [CMake](https://www.cmake.org/) tool.
18It can be used in graphical mode by using GTK or in text-based mode by using NCurses. A dump mode is present from command line.
19
20***
21
22# Table of contents
23- [Table of contents](#table-of-contents)
24  - [Dependencies](#dependencies)
25    - [Build-only dependencies](#build-only-dependencies)
26    - [Build and run dependencies](#build-and-run-dependencies)
27  - [Download and install](#download-and-install)
28    - [From official repositories](#from-official-repositories)
29    - [From third-party repositories](#from-third-party-repositories)
30    - [From GitHub releases](#from-github-releases)
31    - [Manual build](#manual-build)
32  - [Usage](#usage)
33  - [Wiki](#wiki)
34  - [Bugs/Improvements/Request features](#bugsimprovementsrequest-features)
35  - [Translate CPU-X](#translate-cpu-x)
36
37***
38
39## Dependencies
40
41### Build-only dependencies
42
43These dependencies are needed to **build** CPU-X:
44* A C compiler ([GCC](https://gcc.gnu.org/) or [Clang](https://clang.llvm.org/))
45* [CMake](https://www.cmake.org/)
46* [Pkg-Config](https://www.freedesktop.org/wiki/Software/pkg-config/) / [Pkgconf](https://github.com/pkgconf/pkgconf)
47* [NASM](http://www.nasm.us/)
48
49### Build and run dependencies
50
51These dependencies are needed to **build¹** and **run** CPU-X:
52* [GTK3+](https://www.gtk.org/) (version 3.12 or newer is needed)
53* [NCurses](https://www.gnu.org/software/ncurses/)
54* [Libcpuid](http://libcpuid.sourceforge.net/) (version 0.3.0 or newer is needed)
55* [Pciutils](https://mj.ucw.cz/sw/pciutils/)
56* [Procps-ng](https://sourceforge.net/projects/procps-ng/) (Linux) / [Libstatgrab](https://www.i-scream.org/libstatgrab/) (*BSD)
57**¹**On some GNU/Linux distributions, the appropriate **-dev** or **-devel** package is needed.
58
59## Download and install
60
61### From official repositories
62
63In alphabetical order:
64- [Debian (since version 11 "Bullseye")](https://packages.debian.org/search?searchon=names&keywords=cpu-x): `apt install cpu-x`
65- [Fedora (since version 30)](https://src.fedoraproject.org/rpms/cpu-x): `dnf install cpu-x`
66- [FreeBSD (since version 11)](https://www.freshports.org/sysutils/cpu-x): `pkg install cpu-x`
67- [OpenMandriva Lx (since version 4.0 "Nitrogen")](https://github.com/OpenMandrivaAssociation/cpu-x): `dnf install cpu-x`
68- [Solus](https://packages.getsol.us/shannon/c/cpu-x/): `eopkg install cpu-x`
69- [Ubuntu (since version 20.04 "Focal Fossa")](https://packages.ubuntu.com/search?suite=default&section=all&arch=any&keywords=cpu-x&searchon=names) : `apt install cpu-x`
70
71### From third-party repositories
72
73- Arch Linux/Debian/openSUSE/Ubuntu (OBS): [cpu-x](https://software.opensuse.org//download.html?project=home%3AXorg&package=cpu-x) / [cpu-x-git](https://software.opensuse.org//download.html?project=home%3AXorg&package=cpu-x-git)
74- Arch Linux (AUR): [cpu-x](https://aur.archlinux.org/packages/cpu-x/) / [cpu-x-git](https://aur.archlinux.org/packages/cpu-x-git/)
75- Slackware: on [SlackOnly](https://slackonly.com/)
76
77### From GitHub releases
78
79Look for **Assets** [here ![GitHub release](https://img.shields.io/github/release/X0rg/CPU-X.svg)](https://github.com/X0rg/CPU-X/releases/latest) for packages and AppImage.
80
81### Manual build
82
83For step-by-step guide, please read [this page](https://github.com/X0rg/CPU-X/wiki/manual-build) on the Wiki.
84
85## Usage
86
87Application is available in menu (**System Tools** category). If you start the daemon, it will allow CPU-X to access some special devices, which provides more information and avoid empty labels.
88The CPU-X daemon requires root privileges, and it uses Polkit for privileges escalation.
89
90You can use `cpu-x` from command line, some options are available, like:
91- `--gtk`: to start the graphical user interface (default)
92- `--ncurses`: to start the text-based user interface
93- `--dump`: to get a summary of data
94
95Use `--help` to see all arguments.
96
97## Wiki
98
99More informations are available on Wiki, like screenshots, troubleshooting and tips. You can access to the Wiki with [this link](https://github.com/X0rg/CPU-X/wiki).
100
101## Bugs/Improvements/Request features
102
103Please [open a new issue](https://github.com/X0rg/CPU-X/issues/new/choose) and fill the appropriate template. Note that text between `<!-- ... -->` is not displayed.
104
105## Translate CPU-X
106
107If you want to translate CPU-X in your native tongue, please visit the [Weblate page](https://hosted.weblate.org/engage/cpu-x/?utm_source=widget).
108