An IRC client for mobile devices

Find a file

Simon Ser ff703240f0 All checks were successful builds.sr.ht/android Job completed Details link_preview: workaround HTTP redirect Dart SDK bug Avoids crashes on non-HTTP redirects.		2025-06-05 22:04:04 +02:00
.builds	ci: upgrade JDK to v21	2025-04-03 20:33:23 +02:00
android	Upgrade flutter_local_notifications to v19	2025-04-03 19:30:06 +02:00
doc	doc/connect: explain TLS cert pinning	2024-11-10 13:25:52 +01:00
ios	ios: Update deployment target to iOS 15.0	2024-12-29 20:45:27 +01:00
lib	link_preview: workaround HTTP redirect Dart SDK bug	2025-06-05 22:04:04 +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	Upgrade dependencies	2025-05-22 11:53:05 +02:00
pubspec.yaml	Add basic emoji picker	2025-05-11 11:02:35 +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.