jm-tech-power-official/Beacon
Beacon — a photo-sharing app built on JM Tech Power chat. Post photos with captions to a shared feed (a chat group), scroll an Instagram-style feed, and like posts. Photos live in your JMDrive. Built with Qt (PySide6).
Beacon — an Instagram-style photo app for JM Tech Power
Share photos with your group. Your feed is a JM Tech Power chat group; your photos live in JMDrive.
- Version: 1.0.0
- Category: Social / Photography
- OS: Linux, macOS, Windows
- Runtime: Python 3 + PySide6 (installed into an isolated per-app venv)
Beacon turns one of your JM Tech Power chat groups into a photo feed. When you post a photo it is uploaded to JMDrive, shared with a public link, and announced in the group. Beacon reads those announcements back and renders them as a vertically scrolling, Instagram-style feed of cards — image, author, timestamp, caption, and a Like button.
Install
Each installer creates an isolated virtualenv for Beacon (it does not touch your system Python or other apps) and puts a beacon launcher on your PATH.
Linux / macOS (user-local, no sudo):
./install.sh # app -> ~/.local/share/beacon, launcher -> ~/.local/bin/beacon # Linux also gets a ~/.local/share/applications/beacon.desktop entry
Windows (PowerShell, from the unzipped folder):
.\install.ps1 # app -> %LOCALAPPDATA%\Programs\beacon, adds beacon.cmd to your PATH
Uninstall with ./uninstall.sh (Linux/macOS) or .\uninstall.ps1 (Windows).
Run
beacon # launch the app beacon --version # -> beacon 1.0.0 beacon --selftest # headless smoke test (offscreen), exit 0
Signing in
On first launch Beacon looks for the jm CLI's config at ~/.config/jm/config.json and, if it finds a token there, reuses that host + token automatically. Otherwise it shows a login dialog:
- Host — defaults to
https://www.jmtechpower.com - API token — create one at /settings/tokens on your site
Your choice is validated against GET /api/v1/user and saved to ~/.config/beacon/config.json. All API calls send Authorization: Bearer <token>.
Using Beacon
- Pick a feed group from the dropdown in the top bar (your chat groups come
from GET /api/v1/chat/groups). The choice is remembered.
- The feed loads from
GET /api/v1/chat/messages?group=<id>, newest first. - + New post → choose an image → add an optional caption → Share.
Beacon uploads the image to JMDrive (POST /api/v1/drive/upload, public), ensures a public share link (POST /api/v1/drive/<id>/share), then posts the announcement to the group (POST /api/v1/chat/send).
- ♥ Like sends a
!beaconlike <post_id>reply to the group; the like count
is the number of such replies for that post.
How posts are stored (the wire format)
Beacon encodes each photo post as a plain chat message so it round-trips through the normal chat API and is human-readable in any chat client:
!beacon1 https://www.jmtechpower.com/d/<token> First line of caption Second line of caption
- First line:
!beacon1 <image_share_url>(the JMDrive public landing link). - Remaining lines: the caption, verbatim (multi-line supported).
A like is its own message:
!beaconlike <post_message_id>
Images are downloaded for display from the share link's raw file endpoint (<share_url>/file) in a background thread, then scaled with rounded corners.
Non-photo messages (ordinary chat text, likes, or anything not starting with !beacon1 <url>) are skipped — they never appear as photo cards. When a group has no photo posts at all, Beacon shows a friendly empty-state card.
Files
- Config:
~/.config/beacon/config.json—{ host, token, group_id, group_name }.
Seeded from ~/.config/jm/config.json on first run if you already use the jm CLI.
- App + venv:
~/.local/share/beacon(Linux/macOS) or
%LOCALAPPDATA%\Programs\beacon (Windows).
Notes
- All networking uses the Python standard library (
urllib) — no third-party
HTTP client. PySide6 is used only for the GUI and is imported lazily, so beacon --version works even without it installed.
- Beacon is a client for JM Tech Power's existing chat + drive APIs; it adds no
server-side component.