https://github.com/sgnn7/ourobo

A lightweight Reddit client for Android
https://github.com/sgnn7/ourobo

android-app android-application reddit reddit-client

Last synced: about 6 hours ago
JSON representation

A lightweight Reddit client for Android

• Host: GitHub
• URL: https://github.com/sgnn7/ourobo
• Owner: sgnn7
• License: mit
• Created: 2011-06-02T04:44:38.000Z (about 15 years ago)
• Default Branch: main
• Last Pushed: 2026-03-01T04:30:08.000Z (4 months ago)
• Last Synced: 2026-03-01T07:21:24.003Z (4 months ago)
• Topics: android-app, android-application, reddit, reddit-client
• Language: Java
• Homepage:
• Size: 14.2 MB
• Stars: 2
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# Ourobo

A lightweight Reddit client for Android.

## Features

- Browse subreddits and switch between them

- View post thumbnails, titles, and scores

- Upvote and downvote posts

- Open posts and comments in a built-in WebView browser

- Add custom subreddits via long-press on the subreddit selector

- Reddit account login with encrypted credential storage (AES-256 via Android Keystore)

## Screenshots

| Post list | Landscape | Menu | Subreddit selector | Custom subreddit |

|---|---|---|---|---|

| ![Post list](docs/images/screenshot_1.png) | ![Landscape](docs/images/screenshot_2.png) | ![Menu](docs/images/screenshot_3.png) | ![Subreddit selector](docs/images/screenshot_4.png) | ![Custom subreddit](docs/images/screenshot_5.png) |

## Requirements

- Android 6.0+ (API 23)

- Internet permission

## Building

Requires Java 11 and the Android SDK (compileSdk 35).

```sh

# Debug build

./gradlew assembleDebug

# Release build

./gradlew assembleRelease

# Install debug build on connected device

./gradlew installDebug

# Run tests

./gradlew test

```

APKs are output to `Ourobo/build/outputs/apk/` with the naming convention `ourobo__.apk`.

## Project Structure

```

Ourobo/

  src/                  # Application source (Java)

  res/                  # Android resources (layouts, drawables, values)

  test/src/             # Unit tests

  AndroidManifest.xml

  build.gradle

OuroboTest/

  src/                  # Instrumentation tests

```

## License

MIT - See [LICENSE.md](LICENSE.md) for details.