An IRC client for mobile devices

Find a file

Simon Ser de0b07ad9c All checks were successful builds.sr.ht/android Job completed Details lib/widget: use const for immutable constructors Fixes the following lints: info • Constructors in '@immutable' classes should be declared as 'const' • lib/widget/link_preview.dart:127:2 • prefer_const_constructors_in_immutables info • Constructors in '@immutable' classes should be declared as 'const' • lib/widget/reactions_sheet.dart:15:2 • prefer_const_constructors_in_immutables		2025-12-30 17:38:53 +01:00
.builds	ci: fix pacman package cache no being deleted	2025-12-29 18:58:28 +01:00
android	android: upgrade Java to v17	2025-11-13 14:36:07 +01:00
doc	doc/firebase: update pushgarden link	2025-12-28 11:51:54 +01:00
ios	ios: Update CocoaPods lock	2025-12-29 16:56:57 +01:00
lib	lib/widget: use const for immutable constructors	2025-12-30 17:38:53 +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	widget/link_preview: Support previewing audio links	2025-12-29 18:22:00 +01:00
pubspec.yaml	widget/link_preview: Support previewing audio links	2025-12-29 18:22:00 +01:00
README.md	readme: migrate issue tracker to Codeberg	2025-12-28 11:51:09 +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 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 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.