On KDE Plasma 6 (StatusNotifierItem host) the tray icon rendered as a solid white square and clicks did nothing. The square is explained by the asset: app_icon.png is a white glyph on transparency, and all 3277 of its fully transparent pixels carry white (255,255,255) RGB. Plasma hands the icon AWT supplies to the StatusNotifier host, which does not honour the alpha channel — so every transparent pixel painted white and the whole 22px tile became a white square. The Linux tray now uses the coloured app icon instead (saturated purple/pink/blue gradient), which survives a lost alpha channel, and skips stripTrayMatteBackground for it — that helper exists to erase a white matte background behind the macOS template glyph, and applied to the coloured icon it would punch holes in its white glyph. macOS and Windows keep the template glyph and the matte stripping exactly as before.
Read in other languages: Русский
FromChat
FromChat is a 100% free and open-source messenger. This repository is the cross-platform client (Android, Desktop via Compose Multiplatform, and iOS).
📥 Download • 💬 Telegram Channel • 🖥️ Server
✨ Features
- Voice and video calls — LiveKit
- Screen sharing during calls (Android)
- Public chat — server-wide community
- Direct messages — legal encryption scheme; server-side E2EE planned
- Device management — active sessions
- Dark mode by default
- Open source
📊 Client Comparison
| Feature | Android | Desktop | Web | iOS |
|---|---|---|---|---|
| Messaging and profiles | ✅ | ✅ | ✅ | ✅ |
| Voice/video calls | ✅ | ✅ | ✅ | ✅ |
| Screen sharing | ✅ | ❌ | ✅ | ❌ |
| Push when backgrounded | ✅ (FCM) | ✅ (persistent WS + tray) | ✅ | ❌ (WS while open) |
| Message reactions | ❌ | ❌ | ✅ | ❌ |
| Rich attachment support | ✅ | ✅ | ❌ | ✅ |
Desktop replaces the former Electron client in the Web repo. Run with ./gradlew :app:desktop:run.
Desktop packaging
Build release packages on the matching OS (or via CI):
| Task | Host | Artifacts |
|---|---|---|
./gradlew :app:desktop:packageReleaseMac |
macOS | FromChat-<ver>-macOS.dmg |
./gradlew :app:desktop:packageReleaseLinux |
Linux | .deb, .rpm, .AppImage (needs appimagetool) |
./gradlew :app:desktop:packageReleaseWindows |
Windows | FromChat-Setup-<ver>.exe, FromChat-Portable-<ver>.exe (Rust toolchain required) |
./gradlew :app:desktop:packageReleaseDesktop |
current OS | delegates to the task above |
Outputs land under app/desktop/build/distributions/release/.
CI: .github/workflows/desktop-release.yml runs on v* tags and workflow_dispatch (required version input), then uploads assets to a GitHub Release.
Windows portable: extracts into a folder where only FromChat Portable.exe is visible; other runtime files are Hidden. Data is stored in a Hidden fromchat-data/ next to that EXE (-Dfromchat.portable=true).
Installed data: Windows %LOCALAPPDATA%\FromChat, macOS ~/Library/Application Support/FromChat, Linux ~/.local/share/FromChat (migrates from legacy ~/.fromchat/cache when present).
🏗️ Tech Stack
- Kotlin
- Compose Multiplatform
- Material Design 3
- Ktor Client
- LiveKit — calls
- SQLDelight — local storage
- Firebase Messaging — push
- Coil — images
📥 Build and Development (Android Studio)
Requirements
- Latest Android Studio
- JDK from Android Studio (JetBrains Runtime)
Quick start
-
Clone the repository:
git clone https://github.com/fromchat-messenger/android.git cd android -
Generate keys (Debug & Release):
DEBUG_STORE_PASS=CHANGEME DEBUG_KEY_PASS=CHANGEME RELEASE_STORE_PASS=CHANGEME RELEASE_KEY_PASS=CHANGEME mkdir -p app/android/keys # Quote passwords: characters like & * ? ! break unquoted shell args. keytool -genkey -v -keystore app/android/keys/debug.jks \ -keyalg RSA -keysize 2048 -validity 10000 \ -alias key0 -storepass "$DEBUG_STORE_PASS" -keypass "$DEBUG_KEY_PASS" \ -dname "CN=Debug, O=FromChat, C=RU" keytool -genkey -v -keystore app/android/keys/release.jks \ -keyalg RSA -keysize 2048 -validity 10000 \ -alias key0 -storepass "$RELEASE_STORE_PASS" -keypass "$RELEASE_KEY_PASS" \ -dname "CN=Release, O=FromChat, C=RU" # Path must be app/android/keys/keystore.properties (matches build.gradle.kts). # Outer "…" / '…' around values are optional; Gradle strips them. cat > app/android/keys/keystore.properties << EOF
releaseStorePassword=$RELEASE_STORE_PASS releaseKeyPassword=$RELEASE_KEY_PASS debugStorePassword=$DEBUG_STORE_PASS debugKeyPassword=$DEBUG_KEY_PASS EOF
3. **Open in Android Studio:** `File → Open` → repo root. Gradle syncs dependencies automatically.
4. **Run:** `Run → Run 'Android'` (or the app debug configuration).
Debug application id: `ru.fromchat.beta`.
### CLI build
```bash
export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"
./gradlew :app:shared:compileAndroidMain :app:android:assembleDebug
APK: app/android/build/outputs/apk/debug/android-debug.apk.
Project structure
android/
├── app/
│ ├── android/ # Android app module
│ └── shared/ # Compose Multiplatform
│ ├── commonMain/
│ ├── androidMain/
│ └── iosMain/ # not ready yet
├── utils/ # reusable utilities
│ ├── android/
│ └── shared/
└── gradle/libs.versions.toml
Code style: CODE_STYLE.md.
🤝 Contribute
Pull requests are welcome. For large changes, follow CODE_STYLE.md.
📄 License
GNU Affero General Public License v3.0 — see LICENSE.