Skip to main content

alphasignpy

A comprehensive, modern Python library for controlling Alpha Sign LED displays over serial.

Full implementation of the Alpha Sign Communications Protocol (M-Protocol).

Original library by prototux. Rewritten and extended by Lance Reinsmith.


Documentation

Full API documentation is available at https://lancereinsmith.github.io/alphasignpy/


Features

  • Comprehensive protocol coverage — Write/Read TEXT, STRING, SMALL/LARGE/RGB DOTS, SPECIAL FUNCTIONS, ALPHAVISION BULLETIN
  • ACK/NAK error checking with full exception hierarchy
  • DTR control to prevent accidental sign resets
  • Image conversion from any RGB image to the 9-colour sign palette
  • Text formatting helpers — colours, fonts, speed, date/time, animation, counters

Installation

pip install alphasignpy

Quick Start

from alphasign import Sign, Packet, SignType
from alphasign.commands import WriteText, WriteSpecialFunction
from alphasign.protocol import DisplayMode, Color, FileType
from alphasign.text_format import color

# Open connection
sign = Sign(sign_type=SignType.ALPHA_2X0C, address="01")
sign.open("/dev/ttyUSB0", dtr=False)

# Configure memory (one-time setup)
pkt = Packet(type_code=sign.type_code, address=sign.address)
pkt.add(WriteSpecialFunction.configure_memory([
    {"label": "A", "type": FileType.TEXT, "size": 256},
]))
sign.send(pkt)

# Send a coloured message
pkt = Packet(type_code=sign.type_code, address=sign.address)
pkt.add(WriteText(
    color(Color.RED) + b"Hello " + color(Color.GREEN) + b"World!",
    label="A",
    mode=DisplayMode.ROTATE,
))
sign.send(pkt)

sign.close()

Protocol Notes

  • Serial framing: 9600 baud, 7E1 (7 data bits, even parity, 1 stop bit)
  • Uses binary framing (not ASCII Printable format)
  • Timing markers (0xFF) are used to insert 100 ms delays; never transmitted
  • Checksums are 16-bit hex sums from STX through ETX

License

MIT License. See LICENSE and NOTICE for details. The original library by prototux was released under the Apache License 2.0.

Metadata

Release files for alphasignpy 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for alphasignpy 0.1.1
File Size Uploaded Provenance Actions
alphasignpy-0.1.1.tar.gz 38.2 kB With provenance Details for alphasignpy-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for alphasignpy 0.1.1
File Interpreter ABI Platform Actions
alphasignpy-0.1.1-py3-none-any.whl Python 3 none any Details for alphasignpy-0.1.1-py3-none-any.whl

Total release size: 77.7 kB

Release files / alphasignpy-0.1.1.tar.gz

Download URL alphasignpy-0.1.1.tar.gz
Size 38.2 kB
Tags Source
SHA-256 checksum
How to use checksums
37b63f027d3195538043e0bfd58faf5fcc5d46e77a7ba0e966a6f729f31449d3
BLAKE2b-256 checksum
How to use checksums
f085e1572914f9d15c4551ee28ff633faa8bacf20947940fe7e61801a3db6fc5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 4, 2026.

Transparency log

Release files / alphasignpy-0.1.1-py3-none-any.whl

Download URL alphasignpy-0.1.1-py3-none-any.whl
Size 39.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7c96b17551084e14c535665cd67cad900332969d26eabba8f932c1ebef204096
BLAKE2b-256 checksum
How to use checksums
9074abff13c1047872c568983c49fb4a68e2813ce54a721047dbfef242901811
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 4, 2026.

Transparency log

Security for alphasignpy 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for alphasignpy-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page