crosspoint-cli

CLI tool to send EPUB books to CrossPoint Reader over WiFi.

Based on the WebSocket/UDP protocol from calibre-plugins. Pure Python, zero dependencies.

Install

uv tool install --editable .
# or
pip install -e .

Usage

# Auto-discover device and send an EPUB
crosspoint send book.epub

# Send multiple files
crosspoint send book1.epub book2.epub

# Send to a specific directory on the device
crosspoint send -d /Books book.epub

# Skip auto-discovery, specify host directly
crosspoint --host 192.168.4.1 send book.epub

# List files on the reader
crosspoint ls
crosspoint ls -r          # recursive, EPUBs only
crosspoint ls /Books      # list a specific directory

# Delete a file
crosspoint rm /Books/book.epub

# Download a file
crosspoint download /Books/book.epub local.epub

# Create a directory
crosspoint mkdir Books

# Discover devices on the network
crosspoint discover

Protocol

The device runs a small web server with:

• UDP discovery — broadcast hello on ports [8134, 54982, 48123, 39001, 44044, 59678], response contains host;ws_port
• WebSocket upload — ws://host:port/ with START:filename:size:path → READY → binary chunks → DONE
• HTTP API — GET /api/files, POST /mkdir, POST /delete, GET /download

Default host: 192.168.4.1, default WebSocket port: 81.

License

MIT