AWT's Linux tray is not built into the JDK: it dlopens libappindicator, and
without it SystemTray.isSupported() is false. The app gates the whole tray on
that call (Main.kt:409) and silently renders nothing when it is false — which
is why the tray on KDE Plasma 6 had no working clicks and no explanation in the
log.
jpackage cannot be told about dependencies through Compose's `linux { }` DSL,
so the generated .deb shipped a control file with no Depends at all and pulled
nothing in. packageReleaseLinux now injects
`libayatana-appindicator3-1 | libappindicator3-1, libdbus-1-3` into that
control file (Ayatana is the maintained package; the legacy name stays as an
alternative for older distros).
The `ar` container is rewritten in Kotlin rather than shelled out to, because
BSD ar (macOS) injects a `__.SYMDEF SORTED` member while GNU ar (Linux, where
this runs) does not, and rebuilding a package with the wrong dialect corrupts
it. Member order is preserved and headers are reused verbatim, with only the
size field refreshed for the replaced control member. Everything is wrapped so
a failure logs a warning and leaves the deb exactly as jpackage built it,
rather than failing the release.
Verified against a synthetic GNU-style .deb: members read back in order
(debian-binary, control.tar.gz, data.tar.gz), the control file gains the
Depends line and keeps Package/Architecture, and the data payload round-trips
intact. BSD `ar t` also reads the result.
Main.kt now logs SystemTray.isSupported() once per run, so the next report
says outright whether the tray was available instead of us inferring it.
Still not covered: the .rpm gets no dependency injection (no jpackage option
and no easy rpm rewrite), and the AppImage still relies on the host having
libappindicator.
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.