Metadata-Version: 2.1
Name: radexreader
Version: 1.2.1
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
Platform: UNKNOWN
Description-Content-Type: text/markdown
License-File: LICENSE

# RadexReader

The RadexReader is an user-space driver for the [RADEX RD1212](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.

![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

[![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.py` for examples.
* Run the command `radexreader` available with DEB/RPM packages.
* Run the command `radexreader.py` available with PYPI package.

## Installation

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

* Debian and Ubuntu: `sudo apt install python3-radexreader radexreader` (coming soon or via [PPA](https://launchpad.net/~luigifab/+archive/ubuntu/packages))

* Fedora: `sudo dnf install python3-radexreader`

* openSUSE: `sudo zypper install python3-radexreader`

* 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)

* Docker Alpine: `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`

## PPA

Installation for Debian and Ubuntu with [PPA](https://launchpad.net/~luigifab/+archive/ubuntu/packages):
```bash
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 hirsute 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 hirsute main" | sudo tee -a /etc/apt/sources.list
sudo apt update
sudo apt install python3-radexreader radexreader
```
```bash
# 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.1 (09/09/2021)
- Compatibility: Python 3.3 / 3.4 / 3.5 / 3.6 / 3.7 / 3.8 / 3.9 / 3.10
- Links: [luigifab.fr](https://www.luigifab.fr/python/radexreader) - [github.com](https://github.com/luigifab/python-radexreader) - [pypi.org](https://pypi.org/project/radexreader/)\
[Debian python-radexreader.deb](https://tracker.debian.org/pkg/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/python3-radexreader)\
[openSUSE python-radexreader.rpm](https://software.opensuse.org/package/python-radexreader)\
[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.


