Metadata-Version: 2.4
Name: radexreader
Version: 1.3.0
Summary: Python library for the RADEX RD1212 and the RADEX ONE Geiger counters.
Home-page: https://github.com/luigifab/python-radexreader
Author: Fabrice Creuzot
Author-email: code@luigifab.fr
License: GPL 2
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyusb
Requires-Dist: pyserial
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# RadexReader

The RadexReader is an user-space driver for the [RADEX RD1212 v1/v2](https://quartarad.com/product-category/radiation-detector/) and the [RADEX ONE](https://quartarad.com/product-category/radiation-detector/) Geiger counters. It allow to read and clear stored data via USB. Warning! This tool is completely unrelated with QuartaRad.

This tool was initially developed with RD1212 v2.48.

![RADEX RD1212](https://raw.githubusercontent.com/luigifab/python-radexreader/master/images/RD1212.jpg?raw=true)
![RADEX ONE](https://raw.githubusercontent.com/luigifab/python-radexreader/master/images/ONE.jpg?raw=true)

## Screenshots and Usage

[![Screnshot 1](https://raw.githubusercontent.com/luigifab/python-radexreader/master/images/thumbs/read.png?raw=true)](https://raw.githubusercontent.com/luigifab/python-radexreader/master/images/read.png?raw=true)
[![Screnshot 2](https://raw.githubusercontent.com/luigifab/python-radexreader/master/images/thumbs/compare.png?raw=true)](https://raw.githubusercontent.com/luigifab/python-radexreader/master/images/compare.png?raw=true)

* Read `src/radexreader-cli.py` for examples.
* Run the command `radexreader` available with DEB/RPM packages.
* Run the command `.../radexreader-cli.py` available with PYPI package.

## Installation

It require *libusb*, *pyusb* and *pyserial*.

#### Installation for Debian, Devuan, Ubuntu, Trisquel, Linux Mint, MX Linux

* `sudo apt install python3-radexreader radexreader`

#### Installation for Fedora

* `sudo dnf install python3-radexreader`

#### Installation for openSUSE

* `sudo zypper install python3-radexreader`

#### Installation for Mageia

* `sudo urpmi python3-radexreader`

#### Installation for OpenMandriva

* `sudo dnf install python-radexreader`

#### Installation with Docker

* `sudo docker run --rm --user root -it --privileged -v /dev:/dev python:3.13-alpine /bin/sh` then: `apk update ; apk add libusb ; python3 -m pip install radexreader`

If the **Radex ONE** doesn't work, read this [comment](https://github.com/luigifab/python-radexreader/issues/14#issuecomment-2742564354) (`modprobe & echo`).

#### Installation with PIP or Manual installation

* Linux: `sudo python3 -m pip install radexreader` (**+** libusb)
* Mac: `sudo pip install radexreader` (**+** libusb)
* Windows: `python -m pip install radexreader` (**+** [libusb](https://libusb.info/), put libusb-1.0.dll in system32)
* Manual: `git clone` or download archive (**+** libusb)

Please note that **you must authorise** the usage of your device **without root privileges**. To do that, install [python3-radexreader.udev](https://github.com/luigifab/python-radexreader/blob/master/scripts/debian/python3-radexreader.udev) in `/usr/lib/udev/rules.d/60-python3-radexreader.rules` or `/lib/udev/rules.d/60-python3-radexreader.rules`.

If you can't/won't, if the **Radex ONE** doesn't work, read this [comment](https://github.com/luigifab/python-radexreader/issues/14#issuecomment-2742564354) (`modprobe & echo`).

#### Alternative installation for Debian, Devuan, Ubuntu, Trisquel, Linux Mint, MX Linux

```bash
# PPA: https://launchpad.net/~luigifab/+archive/ubuntu/packages
# with Debian 12+/Bookworm+ you can use mantic+ instead of focal (https://unix.stackexchange.com/a/669008/364800)
# for Debian you can use focal for buster, jammy for bullseye, oracular or noble for bookworm, questing or plucky for trixie
# for Devuan you can use focal for beowulf, jammy for chimaera, oracular or noble for daedalus, questing or plucky for excalibur and ceres
# for Trisquel you can use focal for nabia, jammy for aramo
# for Linux Mint you can use focal for 20.x and 4/debbie, jammy for 21.x and 5/elsie, noble for 22.x and 6/faye, questing or plucky for 7/gigi
# for MX Linux you can use focal for 19.x, jammy for 21.x, oracular or noble for 23.x
# for Kali Linux you can use questing or plucky

sudo add-apt-repository ppa:luigifab/packages
sudo apt update
sudo apt install python3-radexreader radexreader
# or
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys FFE5BD439356DF7D
echo "deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main" | sudo tee -a /etc/apt/sources.list
sudo apt update
sudo apt install python3-radexreader radexreader
# or
sudo wget -O /etc/apt/trusted.gpg.d/luigifab.gpg https://www.luigifab.fr/apt.gpg
echo "deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main" | sudo tee -a /etc/apt/sources.list
sudo apt update
sudo apt install python3-radexreader radexreader
# or
wget -qO - https://www.luigifab.fr/apt.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/luigifab.gpg
echo "deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main" | sudo tee -a /etc/apt/sources.list
sudo apt update
sudo apt install python3-radexreader radexreader

# sha256sum /etc/apt/trusted.gpg.d/luigifab.gpg
578c89a677048e38007462d543686b53587efba9f93814601169253c45ff9213
# apt-key list
/etc/apt/trusted.gpg.d/luigifab.gpg
pub   rsa4096 2020-10-31 [SC]
      458B 0C46 D024 FD8C B8BC  99CD FFE5 BD43 9356 DF7D
```

## Copyright

- Current version: 1.3.0 (08/08/2025)
- Compatibility: Python 3.3 / 3.4 / 3.5 / 3.6 / 3.7 / 3.8 / 3.9 / 3.10 / 3.11 / 3.12 / 3.13 / 3.14
- Links: [luigifab.fr](https://www.luigifab.fr/python/radexreader) - [github.com](https://github.com/luigifab/python-radexreader) - [pypi.org](https://pypi.org/project/radexreader/) - [ppa/dpa](https://launchpad.net/~luigifab/+archive/ubuntu/packages)

This program is provided under the terms of the **GNU GPLv2+** license.\
If you like, take some of your time to improve some translations, go to https://bit.ly/2HyCCEc.

## Packages in official distros repositories

[![Packages status](https://repology.org/badge/vertical-allrepos/radexreader.svg?header=radexreader)](https://repology.org/project/radexreader/versions)
