Parseable Android

An Android client for Parseable, the open-source log analytics platform. Browse, search, and filter your log data from your phone.

Features

Server Connection — Connect to any Parseable instance with Basic Auth. Supports both HTTP and HTTPS. Credentials are persisted locally.
Stream Browser — View all log streams with ingestion/storage stats at a glance.
Log Viewer — Browse log entries with expandable detail cards. Tap any entry to see all fields.
Time Range Filtering — Quick-select time ranges from 5 minutes to 30 days.
Text Search — Full-text search across log fields with automatic fallback strategies.
Column Filters — Add SQL-based column filters with operators (=, !=, LIKE, ILIKE, >, <, IS NULL, etc.).
Custom SQL Queries — Write and execute raw PostgreSQL-compatible SQL directly against your log data.
Stream Details — View schema, stats (event count, ingestion size, storage size), and retention config per stream.
Alerts — Browse configured alerts with rule and target details.
Settings — View server info (version, mode, deployment ID, query engine) and user list.
Dark Mode — Full Material 3 dark/light theme support following system preference.
Pull-to-Refresh — Pull to refresh on all list screens.

Tech Stack

Kotlin
Jetpack Compose with Material 3
Hilt for dependency injection
OkHttp for networking
Kotlinx Serialization for JSON
DataStore for local preferences
Navigation Compose for routing

Parseable API Coverage

Endpoint	Method	Used For
`/api/v1/liveness`	GET	Connection test
`/api/v1/about`	GET	Server info
`/api/v1/logstream`	GET	List streams
`/api/v1/logstream/{name}/schema`	GET	Stream schema
`/api/v1/logstream/{name}/stats`	GET	Stream statistics
`/api/v1/logstream/{name}/info`	GET	Stream details
`/api/v1/logstream/{name}/retention`	GET	Retention config
`/api/v1/logstream/{name}`	DELETE	Delete stream
`/api/v1/query`	POST	SQL log queries
`/api/v1/alerts`	GET	List alerts
`/api/v1/user`	GET	List users

Installation

The recommended way to install Parseable Android is via Obtainium, which will automatically notify you of new releases.

Install Obtainium on your device.
Open Obtainium and tap Add App.
Enter this repository URL: https://github.com/ilyakooo0/parseable-android
Tap Add — Obtainium will fetch the latest release APK and install it.

Updates will be detected automatically whenever a new release is published.

Building

./gradlew assembleDebug

The debug APK will be at app/build/outputs/apk/debug/.

CI/CD

The GitHub Actions workflow (.github/workflows/build-release.yml) builds both debug and release APKs. Pushing a tag matching v* creates a draft GitHub release with the APKs attached. You can also trigger the workflow manually.

License

MIT