Files
tcms/macclient/README.md
T
Ty Clifford d0496c93f3 - The Mac client’s Media tab now has pagination and a preview/play area.
What changed in 
[main.m](/Users/tyemeclifford/Documents/GH/blog/macclient/AppKitClient/main.m):
Media list now paginates with Previous/Next and 10/25/50/100 per page.
Selecting an image loads an inline preview.
Selecting audio/video loads an AVPlayerView with native playback 
controls.
Added an Open button and double-click support to open media in the 
default Mac app.
Media file sizes now display as readable values like 1.4 MB.
I also updated 
[build-app.sh](/Users/tyemeclifford/Documents/GH/blog/macclient/build-app.sh) 
to link AVKit and AVFoundation, and to honor the app’s 
CFBundleExecutable from Info.plist so the rebuilt bundle launches with 
the expected TCMS executable.
2026-07-05 18:32:07 -04:00

1.1 KiB

TCMS Mac Client

Native AppKit macOS 12+ client for Ty Clifford's Content Management System.

Run

cd macclient
./build-app.sh
open TCMSMacClient.app

The built app bundle is written to macclient/TCMSMacClient.app.

Connect

Point the client at any TCMS install URL, such as:

https://example.com/blog
http://127.0.0.1:8097

The client automatically calls api.php under that URL. Enter the username/password stored in the site's .env.

Features

  • Create, edit, update, draft, publish, and delete posts and pages.
  • Page through large post/page lists with configurable per-page counts.
  • Toggle spell check and auto-correct in the Markdown editor.
  • Use standard Mac shortcuts, including Command-S for Update, Command-Comma for Settings, and Command-Q for Quit.
  • Upload media to bl-content/uploads.
  • Page through media, preview images, play audio/video, and open files in the default Mac app.
  • List and moderate comments.
  • Local autosave to Application Support.
  • Optional remote autosave as draft.
  • Configurable autosave interval.