cinny/README.md

Lotus Chat

A Matrix client for Lotus Guild — forked from Cinny v4.12.1.

Deployed at chat.lotusguild.org.

---

Changes from upstream Cinny

Branding & Identity

• Package renamed to lotus-chat, description updated to "Lotus Chat — Matrix client for Lotus Guild"
• App title changed from "Cinny" to "Lotus Chat" throughout
• Favicon, PWA icons, and all icon sizes (57×57 → 180×180 Apple touch icons) replaced with Lotus.png variants
• Logo in About dialog and Auth page replaced with official Lotus.png
• Auth footer rewritten: shows dynamic version from package.json, links to lotusguild.org, chat.lotusguild.org, and matrix.lotusguild.org
• Welcome page tagline changed from "Yet another matrix client" to "A Matrix client for Lotus Guild"
• Encryption key export filename changed from cinny-keys.txt to lotus-keys.txt
• manifest.json updated with Lotus name, description, and branding colors

LotusGuild Terminal Design System (TDS) v1.2

A full custom theme engine layered on top of Cinny's vanilla-extract theming:

Dark mode (LotusTerminalTheme):

• CRT terminal aesthetic: scanline overlay, vignette, phosphor glow
• Palette: bg #030508, orange #FF6B00, cyan #00D4FF, green #00FF88, text #c4d9ee
• Monospace font stack, terminal-style scrollbars
• Custom hex-grid and circuit-board CSS background patterns
• Matrix-style boot messages on the welcome page
• CSS variables: --lt-* family covering colors, glow effects, borders, animations

Light mode (LotusTerminalLightTheme):

• Full light palette: bg #edf0f5, orange #c44e00, cyan #0062b8, green #006d35, text #111827
• No CRT effects (scanlines, vignette disabled)
• Light-mode scrollbars, adjusted code block colors, semantic color overrides
• Scoped to html[data-theme="light"] body.lotusTerminalBodyClass
• ThemeManager.tsx sets data-theme attribute based on active theme kind

Chat Backgrounds (18+ custom patterns, all TDS-aware):

• Blueprint grid, carbon fiber, starfield, topographic contours, herringbone, crosshatch
• Chevron, polka dots, triangles, plaid
• All patterns use CSS custom properties — adapt to both TDS dark and light themes
• Settings toggle for showing per-message sender profiles

Voice / Video Call Improvements

• Element Call 0.19.3: Upgraded from 0.16.3. Dist copied to public/element-call/ by vite at build time.
• Camera default OFF: Camera no longer persists across sessions via localStorage. Always starts disabled. Optional cameraOnJoin setting for explicit opt-in.
• Deafen button: Tooltip corrected to "Deafen" / "Undeafen" (was "Turn Off Sound" / "Turn On Sound")
• Screenshare confirmation: A confirm dialog appears before screenshare is broadcast to call participants
• Auto-revert spotlight on screenshare: When someone starts screensharing, EC normally forces all participants into spotlight view. Patched in CallControl.ts onControlMutation() — detects the screenshare button going primary and clicks gridButton after 600ms to revert to grid layout. Participants choose to watch screenshare manually.
• Push to Talk (PTT):
  • Configurable keybind (default: Space) via Settings > General > Calls
  • Mic activates on keydown, deactivates on keyup; mic muted on tab blur/focus to prevent stuck-on mic
  • Visual indicator: plain folds Chip by default; when LotusGuild TDS is active: orange PTT — Hold SPACE / green ● LIVE in JetBrains Mono
  • Listens on both main window and EC iframe contentWindow for reliable key capture
  • Implemented via CallControl.setMicrophone() public method on the widget bridge
• Noise suppression toggle: Settings > General > Calls — passes noiseSuppression URL parameter to the embedded Element Call widget
• Call button scoping: The upstream Cinny 4.12.1 call button (voice + video dropdown) is restricted to DMs and private group chats only. Specifically: direct messages, or invite-only rooms that have no m.space.parent state event (i.e. not a space/guild text channel). Public rooms and space channels are excluded to prevent accidental mass-notifications. Room.tsx switches to CallView layout when a call embed is active in the current room.
• Poll display: m.poll.start events (both stable Matrix 1.7 m.poll content key and MSC3381 unstable org.matrix.msc3381.poll.start) render as read-only poll cards inside the standard message bubble — question and answer options shown. Registered as top-level event renderers AND inside the EncryptedContent callback so encrypted polls also display after decryption. "Open in Element to vote" note displayed. Implemented in PollContent.tsx.
• Deleted message placeholder: Redacted m.room.message, m.room.encrypted, and m.sticker events no longer disappear from the timeline. Instead they reach the existing RedactedContent component (trash icon + italic "This message has been deleted" with reason if provided), matching Element, FluffyChat, Commet, and Nheko behaviour. One-line change in the eventRenderer filter in RoomTimeline.tsx.
• Picture-in-picture (PiP): When navigating away from a call room while in an active call, the call embed shrinks to a 280x158px floating window in the bottom-right corner. The PiP window is draggable — drag it anywhere on screen to move it out of the way. Clicking (without dragging) navigates back to the call room. Drag vs click distinguished by a 5px movement threshold; touch drag supported. Imperative style overrides on callEmbedRef.current via useEffect — a wrapper div cannot be used because useCallEmbedPlacementSync writes top/left/width/height directly onto that element.