root
75a05cf83d
Drag the PiP window anywhere on screen to move it out of the way. Click (without dragging) still navigates back to the call room. 5px movement threshold distinguishes drag from click. Mouse and touch both supported. Cursor shows grab/grabbing cues.
63 lines
4.6 KiB
Markdown
63 lines
4.6 KiB
Markdown
# Lotus Chat
|
||
|
||
A Matrix client for [Lotus Guild](https://lotusguild.org) — forked from [Cinny](https://github.com/cinnyapp/cinny) v4.11.1.
|
||
|
||
Deployed at [chat.lotusguild.org](https://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
|
||
- **DM calls**: Phone button in DM room header starts a 1-on-1 call via `useCallStart(true)`. `Room.tsx` switches to CallView layout when the DM has an active call embed. Standard voice rooms were already supported; this extends call support to all direct messages.
|
||
- **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.
|