Tobias/Fichero
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add web GUI section to README

Browse Source
This commit is contained in:
Hamza
2026-02-24 00:52:06 +01:00
parent 3be418369d
commit d8af89d326
1 changed files with 11 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
README.md
View File

@@ -1,6 +1,6 @@
# fichero-printer # fichero-printer
Python CLI tool and protocol documentation for the Fichero D11s thermal label printer. Web GUI, Python CLI, and protocol documentation for the Fichero D11s thermal label printer.
Blog post: [Reverse Engineering Action's Cheap Fichero Labelprinter](https://blog.hamza.homes/reverse-engineering-fichero-label-printer/) Blog post: [Reverse Engineering Action's Cheap Fichero Labelprinter](https://blog.hamza.homes/reverse-engineering-fichero-label-printer/)
@@ -53,7 +53,15 @@ The printer uses a proprietary command set prefixed with `10 FF`. It borrows one
The key discovery from decompiling the Fichero APK: the D11s is an "AiYin" device class that needs specific enable/stop commands (`10 FF FE 01` / `10 FF FE 45`). Using the wrong pair means the printer accepts image data silently but never actually prints. The key discovery from decompiling the Fichero APK: the D11s is an "AiYin" device class that needs specific enable/stop commands (`10 FF FE 01` / `10 FF FE 45`). Using the wrong pair means the printer accepts image data silently but never actually prints.
## Setup ## Web GUI
Open `web/index.html` in Chrome or Edge. No server needed, no dependencies, no build step.
Click Connect, pair with the printer through the browser's Bluetooth dialog, and you're ready to print. The UI has two tabs: one for text labels (with a live 96px preview) and one for image labels (drag-and-drop). Device info, battery, and settings are all accessible from the same page.
Requires Web Bluetooth, so Chrome/Edge/Opera only. Firefox and Safari don't support it.
## CLI Setup
Requires Python 3.10+ and uv. Turn on the printer and run: Requires Python 3.10+ and uv. Turn on the printer and run:
@@ -73,7 +81,7 @@ You can also pass it per-command:
uv run printer.py --address AA:BB:CC:DD:EE:FF info uv run printer.py --address AA:BB:CC:DD:EE:FF info
``` ```
## Usage ## CLI Usage
``` ```
uv run printer.py --help uv run printer.py --help