An IRC client for mobile devices https://goguma.im

android ios irc linux-mobile mobile

Dart 96%
CMake 1.9%
C++ 1.2%
Ruby 0.4%
Swift 0.2%
Other 0.3%

Find a file

Simon Ser bb46ca87d4 All checks were successful builds.sr.ht/android Job completed Details client_controller: handle REDACT in _handleChatMessages() Makes it so we correctly mark a message as redacted if it's in the same chathistory batch.		2026-03-13 23:53:32 +01:00
.builds	ci: fix pacman package cache no being deleted	2025-12-29 18:58:28 +01:00
android	android: switch launchMode from singleInstance to singleTask	2026-03-12 13:06:29 +01:00
doc	doc/android-debugging: add logcat PID filter example	2026-03-12 12:52:02 +01:00
ios	ios: add NSCameraUsageDescription	2026-01-21 08:32:40 +01:00
lib	client_controller: handle REDACT in _handleChatMessages()	2026-03-13 23:53:32 +01:00
linux	widget/link_preview: Support previewing audio links	2025-12-29 18:22:00 +01:00
test	Depend on flutter_test instead of test	2025-12-06 10:04:23 +01:00
tool	tool/gen_main: Fix import order	2024-04-25 14:40:45 +02:00
.gitignore	gitignore: add devtools_options.yaml	2024-12-20 23:43:49 +01:00
.metadata	linux: add boilerplate files	2023-01-14 19:18:21 +01:00
analysis_options.yaml	Enable sort_pub_dependencies lint	2025-10-09 14:29:50 +02:00
LICENSE	Add app skeleton	2021-03-15 18:58:37 +01:00
pubspec.lock	Upgrade flutter_local_notifications to v21	2026-03-12 12:40:49 +01:00
pubspec.yaml	Upgrade flutter_local_notifications to v21	2026-03-12 12:40:49 +01:00
README.md	readme: add instructions to connect to localhost from Android emulator	2026-03-12 12:35:39 +01:00

README.md

goguma

An IRC client for mobile devices.

Modern: support for many IRCv3 extensions, plus some special support for IRC bouncers.
Easy to use: offer a simple, straightforward interface.
Offline-first: users should be able to read past conversations while offline, and network disruptions should be handled transparently
Lightweight: go easy on resource usage to run smoothly on older phones and save battery power.
Cross-platform: the main target platforms are Linux and Android, iOS is also supported.

If you want to try out goguma on Android, you can use our F-Droid repository which provides nightly builds. Goguma is also available on the official F-Droid repository. Community-supported Goguma versions are available on Google Play Store, Apple App Store and AltStore PAL.

For more information about using Goguma, see our documentation.

Compiling

For the Linux platform

Develop with:

flutter run -d linux

Build with:

flutter build linux

The built binary is in build/linux/release/bundle/goguma.

For the Android platform

Build with:

flutter build apk

The built APK is in build/app/outputs/flutter-apk/app-release.apk.

When running from the Android emulator, the server address irc+insecure://10.0.2.2 can be used to connect to a locally running IRC server.

For the iOS platform

Build with:

flutter build ios # Build .app
flutter build ipa # Build .ipa
flutter build ipa --release # Build .ipa for App Store/Testflight

The built ipa file is in build/ios/ipa, ready for upload with Transporter.

Please note that the bundle identifier is currently hardcoded to the one currently being used for App Store distribution. You may want to change it if you want to distribute Goguma yourself on the App Store, or a third-party platform.

Contributing

Send patches and report bugs on Codeberg. Discuss in #goguma on Libera Chat.

License

AGPLv3 (see LICENSE) with an application store exception. As an additional permission under section 7, you are allowed to distribute the software through an application store, even if that store has restrictive terms and conditions that are incompatible with the AGPL, provided that the source is also available under the AGPL with or without this permission through a channel without those restrictive terms and conditions.