# 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.


## Screenshots and Usage
[](https://raw.githubusercontent.com/luigifab/python-radexreader/master/images/read.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 with PIP
* With Linux: `sudo python3 -m pip install radexreader` (+libusb)
* With Mac: `sudo pip install radexreader` (+libusb)
* With Windows: `python -m pip install radexreader` (+[libusb](https://libusb.info/), put libusb-1.0.dll in system32)
#### Installation with Docker
* `sudo docker run --rm --user root -it --privileged -v /dev:/dev python:3.x-alpine /bin/sh` then: `apk update ; apk add libusb ; python3 -m pip install radexreader`
#### Alternative installation for Debian, Devuan, Ubuntu, Trisquel, Linux Mint, MX Linux
```bash
# PPA: https://launchpad.net/~luigifab/+archive/ubuntu/packages
# with Debian 12+ you can use mantic+ instead of focal (https://unix.stackexchange.com/a/669008/364800)
# for Debian you can use bionic for buster, focal for bullseye, noble for bookworm and trixie
# for Devuan you can use bionic for beowulf, focal for chimaera, noble for daedalus
# for Trisquel you can use focal for nabia, jammy for aramo
# for Linux Mint you can use focal for 20.x and 5, jammy for 21.x, noble for 22.x and 6
# for MX Linux you can use focal for 19.x and 21.x, noble for 23.x
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.2.5 (03/03/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](https://pypi.org/project/radexreader/)\
[Arch Linux python-radexreader.zst](https://aur.archlinux.org/packages/python-radexreader)\
[Debian python-radexreader.deb, radexreader.deb](https://packages.debian.org/python3-radexreader)
*([ITP](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=973447),
[RFS](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=974217))*\
[Fedora python-radexreader.rpm](https://src.fedoraproject.org/rpms/python-radexreader)\
[openSUSE python-radexreader.rpm](https://software.opensuse.org/package/python-radexreader)\
[Mageia python-radexreader.rpm](https://madb.mageia.org/package/show/name/python-radexreader/arch/x86_64)\
[Ubuntu PPA](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
[](https://repology.org/project/radexreader/versions)
Raw data
{
"_id": null,
"home_page": "https://github.com/luigifab/python-radexreader",
"name": "radexreader",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Fabrice Creuzot",
"author_email": "code@luigifab.fr",
"download_url": null,
"platform": null,
"description": "# RadexReader\n\nThe 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.\n\nThis tool was initially developed with RD1212 v2.48.\n\n\n\n\n## Screenshots and Usage\n\n[](https://raw.githubusercontent.com/luigifab/python-radexreader/master/images/read.png?raw=true)\n[](https://raw.githubusercontent.com/luigifab/python-radexreader/master/images/compare.png?raw=true)\n\n* Read `src/radexreader-cli.py` for examples.\n* Run the command `radexreader` available with DEB/RPM packages.\n* Run the command `.../radexreader-cli.py` available with PYPI package.\n\n## Installation\n\nIt require *libusb*, *pyusb* and *pyserial*.\n\n#### Installation for Debian, Devuan, Ubuntu, Trisquel, Linux Mint, MX Linux\n\n* `sudo apt install python3-radexreader radexreader`\n\n#### Installation for Fedora\n\n* `sudo dnf install python3-radexreader`\n\n#### Installation for openSUSE\n\n* `sudo zypper install python3-radexreader`\n\n#### Installation for Mageia\n\n* `sudo urpmi python3-radexreader`\n\n#### Installation with PIP\n\n* With Linux: `sudo python3 -m pip install radexreader` (+libusb)\n* With Mac: `sudo pip install radexreader` (+libusb)\n* With Windows: `python -m pip install radexreader` (+[libusb](https://libusb.info/), put libusb-1.0.dll in system32)\n\n#### Installation with Docker\n\n* `sudo docker run --rm --user root -it --privileged -v /dev:/dev python:3.x-alpine /bin/sh` then: `apk update ; apk add libusb ; python3 -m pip install radexreader`\n\n#### Alternative installation for Debian, Devuan, Ubuntu, Trisquel, Linux Mint, MX Linux\n\n```bash\n# PPA: https://launchpad.net/~luigifab/+archive/ubuntu/packages\n# with Debian 12+ you can use mantic+ instead of focal (https://unix.stackexchange.com/a/669008/364800)\n# for Debian you can use bionic for buster, focal for bullseye, noble for bookworm and trixie\n# for Devuan you can use bionic for beowulf, focal for chimaera, noble for daedalus\n# for Trisquel you can use focal for nabia, jammy for aramo\n# for Linux Mint you can use focal for 20.x and 5, jammy for 21.x, noble for 22.x and 6\n# for MX Linux you can use focal for 19.x and 21.x, noble for 23.x\n\nsudo add-apt-repository ppa:luigifab/packages\nsudo apt update\nsudo apt install python3-radexreader radexreader\n# or\nsudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys FFE5BD439356DF7D\necho \"deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main\" | sudo tee -a /etc/apt/sources.list\nsudo apt update\nsudo apt install python3-radexreader radexreader\n# or\nsudo wget -O /etc/apt/trusted.gpg.d/luigifab.gpg https://www.luigifab.fr/apt.gpg\necho \"deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main\" | sudo tee -a /etc/apt/sources.list\nsudo apt update\nsudo apt install python3-radexreader radexreader\n# or\nwget -qO - https://www.luigifab.fr/apt.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/luigifab.gpg\necho \"deb http://ppa.launchpad.net/luigifab/packages/ubuntu focal main\" | sudo tee -a /etc/apt/sources.list\nsudo apt update\nsudo apt install python3-radexreader radexreader\n\n# sha256sum /etc/apt/trusted.gpg.d/luigifab.gpg\n578c89a677048e38007462d543686b53587efba9f93814601169253c45ff9213\n# apt-key list\n/etc/apt/trusted.gpg.d/luigifab.gpg\npub rsa4096 2020-10-31 [SC]\n 458B 0C46 D024 FD8C B8BC 99CD FFE5 BD43 9356 DF7D\n```\n\n## Copyright\n\n- Current version: 1.2.5 (03/03/2025)\n- 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\n- Links: [luigifab.fr](https://www.luigifab.fr/python/radexreader) - [github.com](https://github.com/luigifab/python-radexreader) - [PyPI](https://pypi.org/project/radexreader/)\\\n[Arch Linux python-radexreader.zst](https://aur.archlinux.org/packages/python-radexreader)\\\n[Debian python-radexreader.deb, radexreader.deb](https://packages.debian.org/python3-radexreader)\n *([ITP](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=973447),\n [RFS](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=974217))*\\\n[Fedora python-radexreader.rpm](https://src.fedoraproject.org/rpms/python-radexreader)\\\n[openSUSE python-radexreader.rpm](https://software.opensuse.org/package/python-radexreader)\\\n[Mageia python-radexreader.rpm](https://madb.mageia.org/package/show/name/python-radexreader/arch/x86_64)\\\n[Ubuntu PPA](https://launchpad.net/~luigifab/+archive/ubuntu/packages)\n\nThis program is provided under the terms of the **GNU GPLv2+** license.\\\nIf you like, take some of your time to improve some translations, go to https://bit.ly/2HyCCEc.\n\n## Packages in official distros repositories\n\n[](https://repology.org/project/radexreader/versions)\n",
"bugtrack_url": null,
"license": "GPL 2",
"summary": "Python library for the RADEX RD1212 and the RADEX ONE Geiger counters.",
"version": "1.2.5",
"project_urls": {
"Homepage": "https://github.com/luigifab/python-radexreader"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2c6a44b994893b7b631a99c9db1242e84698f03c17a7b41d3a8d1a06bfc34ea6",
"md5": "63be266d060802a365a6afaa228812fd",
"sha256": "771ac6d25e4cebee0c41fb683ea5b53106b274889179dc02b5f21f3e1ae6dea9"
},
"downloads": -1,
"filename": "radexreader-1.2.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "63be266d060802a365a6afaa228812fd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 14750,
"upload_time": "2025-03-03T20:43:53",
"upload_time_iso_8601": "2025-03-03T20:43:53.966955Z",
"url": "https://files.pythonhosted.org/packages/2c/6a/44b994893b7b631a99c9db1242e84698f03c17a7b41d3a8d1a06bfc34ea6/radexreader-1.2.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-03-03 20:43:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "luigifab",
"github_project": "python-radexreader",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "radexreader"
}