denis0001-dev 845b021432 Flip the tray context menu below the cursor when there is no room above
On GNOME the tray icon sits in the top bar, so the menu could only ever be
placed by clamping: the old code always asked for anchor.y - height, and when
that fell outside the working area coerceIn pinned it to usable.y regardless
of where the click was. That is what made the menu look offset from the click.

Placement now tries up-and-left first and flips to below (and to the right when
there is no room on the left) instead of clamping, with a small 4px gap from the
cursor.
845b021432 · 2026-10-18 14:04:52 +03:00
307 Commits
2026-10-14 00:23:24 +03:00
2026-10-14 00:23:24 +03:00
2026-04-21 14:49:37 +03:00
2026-06-08 21:26:55 +03:00
2026-10-14 00:23:24 +03:00
2026-02-26 15:45:01 +03:00
2026-10-14 00:23:23 +03:00
2026-10-14 00:22:56 +03:00

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

  1. Clone the repository:

    git clone https://github.com/fromchat-messenger/android.git
    cd android
    
  2. 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.

S
Description
No description provided
Readme AGPL-3.0 52 MiB
Languages
Kotlin 90.3%
Rust 6.9%
Shell 0.6%
Python 0.5%
Objective-C 0.5%
Other 1.2%