An IRC client for mobile devices

Find a file

Simon Ser 779b48d014 All checks were successful builds.sr.ht/android Job completed Details Remove isInDebugMode parameter from Workmanager.initialize() It's deprecated and a no-op.		2025-08-17 10:01:10 +02:00
.builds	ci: use in-process Kotlin compiler	2025-08-16 11:59:11 +02:00
android	android: upgrade Kotlin Gradle plugin to v2.1.21	2025-08-15 20:44:18 +02:00
doc	doc/connect: explain TLS cert pinning	2024-11-10 13:25:52 +01:00
ios	ios: Remove webcrypto workaround	2025-08-03 21:44:54 +02:00
lib	Remove isInDebugMode parameter from Workmanager.initialize()	2025-08-17 10:01:10 +02:00
linux	Use system theme accent color	2024-06-06 19:33:19 +02: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	Drop TODO for prefer_const_constructors lint	2025-05-01 21:05:23 +02:00
LICENSE	Add app skeleton	2021-03-15 18:58:37 +01:00
pubspec.lock	Remove flutter_flipped_autocomplete dependency	2025-08-17 10:00:01 +02:00
pubspec.yaml	Remove flutter_flipped_autocomplete dependency	2025-08-17 10:00:01 +02:00
README.md	readme: update screenshots	2025-02-05 22:39:17 +01:00

README.md

goguma

An IRC client for mobile devices.

Goals:

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 the Google Play Store and the Apple App Store.

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.

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 on Codeberg, report bugs on the issue tracker. Discuss in #emersion 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.