JM Tech Power

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).

Public Social Windows, macOS, Linux LGPL-3.0 (PySide6)
README.md

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

  1. 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.

  1. The feed loads from GET /api/v1/chat/messages?group=<id>, newest first.
  2. + 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).

  1. ♥ 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.