bc125py 0.9.3

A Python-based interface for the Uniden BC125AT

BC125Py

A Python-based interface for the Uniden BC125AT radio scanner.

This project aims to be a Linux replacement for the Windows-only Uniden software for the BC125AT. Presently, BC125Py only has a command line interface, but a GUI is planned. Rest assured, the CLI is not hard to use at all!

Installation

sudo pip install bc125py

It is recommended to install bc125py as root.

Quick Start

All command must be ran as root.

Import scanner channels

bc125py import --csv channels.csv

Then, edit the CSV file in a spreadsheet editor!

Note: Bank 1 starts at 1, 2 at 51, bank 2 at 101, etc...
Note: omitting the --csv flag will import all channels and settings, and use the json file format.

Export channels to scanner

bc125py export --csv channels.csv

Note: omitting the --csv flag will export all channels and settings, and use the json file format.

Launch scanner shell

bc125py shell

The shell allows you to send commands directly to the device.

Factory reset the scanner

bc125py wipe

This will erase all channels and reset all settings.

More Usage

The following are top level flags, to be use after the bc125py but before the subcommand.

Flag	Usage
-v	Enable debug messages
-l, --log LOG	Additionally print all debug messages to LOG_FILE
-p, --port PORT	Force BC125Py to use port (device file) PORT
--legacy-detect	Use the legacy automatic port detection method. Try this if BC125Py does not initially detect your scanner. This may produce duplicate results

import/export and --csv

By default, import and export will process all of the scanner's channels and settings, and work with json files. The --csv flag tells these command to process channels only, and work with csv files.

Shell Scripts

The shell subcommand accepts an optional parameter for an input file, to be processed as a script. Run help once inside the shell to learn more. The recommended extension for these scripts is .125at; see the docs directory for examples.

Contributing

• The module bc125py, excluding app, should only contain library (non-executable) code.
• sdo.py shall be for all scanner-data abstraction classes.
• The app module shall be for all executable code.
• app/cli.py shall be the CLI portion of the program.
• app/core.py shall be all common functions for the executable portion of the program, both CLI and GUI.
• app/log.py shall be the logger. Use the logger wherever possible!

Releases

0.9 (current)

• BC125Py is currently in beta.
• I have tested every function on my personal scanner; the program just lacks a large-scale test.
• No coming major changes.
• If there are no reported problems, this release will eventually become 1.0

1.0

• First stable release (see above)

2.0

• GUI release