Awoochan

Awoochan is an unofficial fork of Chance, the imageboard browser built with Flutter for iOS and Android.

This fork adds owo.vg posting integration, offline thread downloading (from Lystus/chan), and ships under a separate Android package ID so it can be installed alongside the official Chance app.

	Official Chance	Awoochan (this fork)
GitHub	moffatman/chan	4cuck/4chan
Android package	com.moffatman.chan	com.chanawoo.app
App name	Chance	Awoochan
owo.vg posting	—	Yes
Thread download / CopyParty / Kuroba import	—	Yes

The app was previously called Chanawoo. Only the name changed — the Android package ID stays com.chanawoo.app so existing installs update in place and keep their settings, saved threads and downloads.

Upstream development continues on the original repository. Awoochan tracks that codebase and layers fork-specific changes on top. Thread downloading, CopyParty sync, alternative gallery layout, and appearance options are integrated from Lystus/chan.

What's different in this fork

• owo.vg integration — post to 4chan through owo.vg (WebSocket posting, captcha UI, Gold Pass login, and related settings).
• Thread downloading — save full threads locally for offline reading, with progress tracking and archive detection.
• CopyParty sync — optional CopyParty server backend for downloaded thread media.
• Kuroba import/export — import threads from Kuroba backups; export and bulk-manage downloaded threads.
• Hide/unhide images — per-image hide filter by MD5.
• Alternative gallery (quilt layout) — optional quilt-style gallery and updated media viewer (Settings → Appearance).
• Side-by-side install — different package ID from Play Store / upstream Chance, so both apps can be installed at once.
• Same gallery album and deep links as Chance — saved images go to the Chance gallery album by default, and chance:// deep links open in Awoochan.
• One-time app data migration — on first launch, if Awoochan has no settings yet and a co-installed com.moffatman.chan app exists with the same signing key, Hive data is copied automatically. Play Store Chance uses a different key, so migration works for fork / sideload builds only, not live sharing with the official app.

Features

All core Chance features are included, plus fork-specific posting support:

• Multi-column layout for larger screens
• WEBM playback and conversion
• Pick images through in-app web search
• Media gallery view
• Save threads, posts, and attachments to a local collection
• Automatically aligns the captcha slider
• Gestures to navigate through replies
• Switch between multiple browsing tabs
• Optional and automatic adjustments for mouse usage
• Regular-expression filters to hide or highlight posts
• Support for archives to access deleted threads or search for posts
• Thread watcher to check for replies
• owo.vg posting for supported boards
• Offline downloaded threads with CopyParty and Kuroba support

Installing on Android

APKs are published on the fork releases page.

Download the APK that matches your device:

• app-arm64-v8a-release.apk — most phones
• app-armeabi-v7a-release.apk — older 32-bit ARM devices
• app-x86_64-release.apk — emulators

If you previously installed Awoochan v123 with empty data, clear Awoochan app storage (or uninstall and reinstall) while a compatible com.moffatman.chan build is still installed, then launch Awoochan again to trigger migration.

Installing on iOS

Awoochan releases are Android-focused. For iOS, use upstream Chance beta testing from the official project.

How to compile

1. Install Flutter
2. Clone and enter this repository:

git clone https://github.com/4cuck/4chan.git
cd 4chan

3. Fetch dependencies:

flutter pub get

4. (Optional) Change the package name (find-and-replace com.chanawoo.app with your own identifier) if you want your own signing keys for distribution.
5. Run build_runner to generate required Dart code:

flutter pub run build_runner build

6. Copy local build secrets (gitignored):

cp .env.example .env

Edit .env and set CHANCE_UA_SECRET to the same value as MEGUCA_CHANCE_UA_SECRET on your Meguca server (awoo.cf). Android builds load this automatically via Gradle; no --dart-define needed. 7. Build a release APK for Android:

./scripts/build_release_apk.sh

Or equivalently: flutter build apk --split-per-abi --release (Gradle reads .env on its own). For iOS/macOS/desktop, use ./scripts/flutter instead of plain flutter so the same .env values are passed through. 8. To build for iOS (Mac and Xcode required):

./scripts/flutter build ios --release

9. For development with a connected device:

flutter run

On Android, flutter run also picks up .env through Gradle.

Chance upstream is developed on Flutter master; if you hit build errors, try flutter channel dev or flutter channel master.

FAQ

Why isn't it displaying the content I expect?

By default, the app is set up to browse a test server. In app settings, edit your content preferences to browse a different imageboard.

Why are some settings on a web page?

To comply with Apple App Store guidelines, not all settings are modifiable in the app.

How can I quickly scroll to the top of a thread?

Tap the status bar.

How can I quickly scroll to the bottom of a thread?

Hold on the post counter at the bottom-right.

How can I get help, report a bug, or request a feature?

For Awoochan / owo.vg issues, open an issue on 4cuck/4chan.

For upstream Chance bugs and features, use the moffatman/chan tracker or the meta imageboard linked from Chance settings.

License

Based on Chance, licensed under version 3 of the GNU General Public License. See LICENSE for more information.