73e098b8eb
Some checks failed
build / apk (push) Has been cancelled
"Share to NikoGPT" now accepts any file type (single or multiple): the stream is read through the content resolver and pushed into the web composer as base64 chunks, so photos and documents land next to the keyboard ready to send. Oversized files are refused with a clear message (the chat takes up to 16 MB). |
||
|---|---|---|
| .forgejo/workflows | ||
| app | ||
| gradle/wrapper | ||
| .gitignore | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| README.md | ||
| settings.gradle.kts | ||
NikoGPT for Android
Open-source Android client for the NikoGPT web chat (chat.n1ko.dev) — a thin, auditable WebView shell around the same web interface that runs in the browser. No analytics, no trackers, no third-party SDKs: the whole app is one activity and a handful of resources.
- Android 10+ (
minSdk 29), targets Android 15. - Everything the web app can do: conversations, attachments (system file picker), images, generated files, settings, themes.
- Share anything to NikoGPT: from another app share text or any file (photos, PDFs, audio, archives…) straight into the composer.
- Downloads go through Android's
DownloadManager(with your session cookies), links to other sites open in the system browser. - Open in the browser only:
chat.n1ko.devloads inside; anything else leaves the app. - TLS errors are never bypassed, no cleartext traffic, no backup.
- Day/night theme follows the system; the page keeps its own theme setting.
- Back gesture navigates the chat history; pull-to-refresh reloads only at the very top of the chat — never inside a presentation, a dialog or another list.
Install
Download the APK from the releases page: https://git.n1ko.dev/Niko/nikogpt_android/releases
Latest build: https://git.n1ko.dev/Niko/nikogpt_android/releases/download/v1.3.0/nikogpt-android-1.3.0.apk
Open the APK on the phone (allow installing apps from this source when Android asks). The APKs are signed with the project's release key; Android may still warn because the app is installed from outside Play.
Build
Requirements: JDK 17, Android SDK (platform 35, build-tools 35.0.0).
./gradlew assembleDebug # app/build/outputs/apk/debug/app-debug.apk
./gradlew assembleRelease # release; signed with the keystore when configured
Or just open the project in Android Studio.
Release signing
The published APKs are signed with the project's release keystore
(keystore.properties + the .jks file, both outside git). To build them
yourself, create a keystore and point keystore.properties at it:
keytool -genkeypair -v -keystore nikogpt.jks -alias nikogpt \
-keyalg RSA -keysize 2048 -validity 10000
cat > keystore.properties <<EOF
storeFile=../nikogpt.jks
storePassword=...
keyAlias=nikogpt
keyPassword=...
EOF
./gradlew assembleRelease
Installing over a debug-signed build requires uninstalling it first (the
signatures differ). The release certificate's SHA-256 must be listed in
web.android_cert_sha256 in the bot config for App Links verification.
Sign-in
All credentials live on NikoAuth (auth.n1ko.dev): password, e-mail codes,
2FA and Google. The app opens the login in the system browser — Google
refuses WebView logins, and a WebView never shares the browser's cookie jar —
and comes back through a verified App Link
(https://chat.n1ko.dev/app-auth?...) once the login is done; the server
hands the fresh session to the app's WebView on that link. Requires the
release certificate's SHA-256 in the bot's web.android_cert_sha256 for
App Links verification.
Structure
| Path | Purpose |
|---|---|
app/src/main/java/dev/n1ko/nikogpt/MainActivity.kt |
the whole app: WebView setup, file chooser, downloads, back handling |
app/src/main/res/layout/activity_main.xml |
WebView + progress bar + retry screen |
.forgejo/workflows/build.yml |
CI: builds the APK on tags |
License
MIT — see LICENSE. The Tabler-based icons used by the web chat come from f.n1ko.dev/assets/ui (MIT).