Skip to content

Team-Juicr/Juicr

Repository files navigation

Juicr banner

Android CI Android Release Latest release Juicr website DMCA Protected License Support on Ko-fi

Latest release · Website · Support · Release checklist · Changelog · Contributing · Security


Features

Source-gated start

Fresh installs start empty, and users decide which browsing, playback, subtitle, trailer, add-on, personal server, or TV options to enable.

Home and discovery

Browse curated shelves, search across available catalog areas, and move into details without losing your place.

Library tools

Save titles, organize lists, continue watching, and keep completed history close to the experiences that need it.

Redacted support

Diagnostics are shaped around safe counts, labels, and timing evidence instead of private playback or account details.


Screenshots

Juicr app screen

Juicr
Browse, save, organize, and play.

Juicr Home screen

Home
Curated shelves and quick paths.

Juicr Discovery screen

Discovery
Search, browse, and filter.

Juicr Library screen

Library
Lists, history, and saved titles.

Juicr Details screen

Details
Artwork and playback choices.

Juicr Metrics screen

Metrics
Safe support signals.

Juicr Add-ons screen

Add-ons
Optional capabilities users choose to enable.

Juicr Login screen

Login
Account access for sync features.


How To Use

  1. Install Juicr. Start with the Android release APK that matches your device, or use the universal APK when you are not sure.
  2. Choose your setup. Juicr does not provide media on a fresh install. Enable only the options you want to use.
  3. Browse Home and Discovery. Use curated shelves, search, filters, and details pages to find what you want to save or play.
  4. Build your Library. Save titles, create lists, revisit continue watching, and keep completed items organized.
  5. Open Settings when needed. Tune playback, account, appearance, and privacy-conscious support options from one place.
  6. Share safe diagnostics. When support needs evidence, export reports that avoid private source, account, and playback details.

Advanced And Power Users

If you like shaping your own setup, Juicr has you covered. Power users can connect personal servers, add trusted add-ons, tune guarded playback paths, and keep separate source lanes organized without turning a fresh install into a one-size-fits-all app.

Personal servers

Connect your own library and keep it in its own lane. Juicr provides the browsing and playback experience while you manage the server and access.

Add-ons

Use optional manifests for extra catalog, playback, subtitle, trailer, or Live TV capabilities. You choose what to add, enable, and trust.

Advanced P2P

Use guarded P2P playback only when it is available, enabled, and approved. Safety checks keep this lane separate from ordinary browsing.

TV and Web

Some advanced tools are shaped for specific lanes. TV keeps controls remote-first, while Web stays focused on companion browsing and safe surfaces.

Diagnostics for these features stay redacted. Juicr uses safe labels, counts, and status signals instead of exposing private server, account, connector, or playback details.

What Each App Is For

Juicr Android

The main mobile app for Home, Discovery, Library, playback, account sync, and redacted diagnostics.

Juicr TV

A lean-back app shaped for remote control, focus navigation, large screens, and TV-first browsing.

Juicr Web

A browser companion with Juicr-style Home, Discovery, Library, and Settings surfaces.

Release Downloads

Release assets are grouped by app lane. Android mobile and TV each ship a universal APK plus the same ABI-specific APK set.

Universal

Use this APK when you want one package that covers all supported Android device architectures.

arm64-v8a

Recommended for most newer Android phones, tablets, and TV devices.

armeabi-v7a

Use this for older 32-bit Android devices that still need a smaller compatible build.

x86_64

Useful for compatible emulator and desktop-style Android environments.

How It Fits Together

flowchart LR
    A["Juicr Android"] --> D["Home and Discovery"]
    B["Juicr TV"] --> D
    C["Juicr Web"] --> D
    D --> E["Library and lists"]
    D --> F["Playback choices"]
    D --> G["Safe diagnostics"]
    E --> H["Account sync when enabled"]
    G --> I["Redacted support evidence"]
Loading

Juicr keeps browsing, playback choices, library state, and support evidence separated so users stay in control of what they enable and what they share.

Quick Start

  1. Clone the repository.
  2. Open Juicr Android/, Juicr TV/, or Juicr Web/ depending on the app lane.
  3. Run the narrow setup command for that lane.
  4. Use the narrowest lane check available for the code you changed, then confirm CI on the branch.

Build

Use these commands from the matching app folder when building locally:

  • flutter pub get to install Flutter dependencies.
  • flutter analyze for a focused static check.
  • flutter build apk --release for an Android universal release APK.
  • flutter build apk --release --split-per-abi for Android ABI APKs.

For release publishing, use the GitHub Actions Android Release workflow. It rebuilds v1.0.1 and future tags from the repository, restores signing from repository secrets, and uploads separated Android and TV APK assets.

Project Structure

  • Juicr Android/ - Android mobile app source
  • Juicr TV/ - TV app source
  • Juicr Web/ - Web/PWA companion source
  • assets/ - README and public-safe brand assets
  • .github/ - CI, release, Dependabot, and contribution automation
  • CHANGELOG.md - release note source
  • RELEASES.md - tag and publish checklist
  • CONTRIBUTING.md - contribution guidelines
  • SECURITY.md - security reporting guidance
  • CODEOWNERS - review ownership hints
  • LICENSE - repository license terms

For Contributors

Before you send a PR

  • Run the narrowest relevant doctor or focused check for the lane you changed.
  • Update release notes when the change affects the shipped app or release automation.
  • Keep README, screenshots, and docs aligned with visible UI changes.

Keep an eye on

  • User-facing copy should stay neutral and product-safe.
  • Diagnostics should stay redacted and avoid private playback or account details.
  • Release artifacts should be generated by CI or temporary local tooling, not committed.

Privacy And Safety

Juicr diagnostics are designed to be redacted. Support packets should use safe summaries, screenshots, and timing evidence only.

Diagnostics, logs, app UI, exported reports, and repository examples should avoid private account, source, device, and playback details.

License

Copyright (c) Team Juicr. All rights reserved.

This repository is available for public viewing only. No permission is granted to copy, modify, redistribute, sublicense, sell, host, or create derivative works from Juicr without written permission from Team Juicr.

About

An Android app for the sources you choose. Browse, save, resume, and play without turning your media setup into a control room.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors