Agora Interactive Live Streaming
Real-time interactive live video with sub-second latency.
Streama
Your personal Netflix for organizing movies and TV shows
Streama lets you catalog, browse, and stream your own collection of movies and TV series with a Netflix-style interface, auto-filled metadata, drag-and-drop uploads, and local file bulk import.
Overview
Overview
Streama is a self‑hosted media server that turns a personal collection of movies and TV series into a Netflix‑like streaming experience. It targets home users, small households, or hobbyists who want a tidy, web‑accessible catalogue without relying on commercial services.
Core capabilities
The application automatically pulls metadata and artwork from TheMovieDatabase.org using an API key, populating titles, descriptions, and images. Users can add content via drag‑and‑drop uploads or by pointing the system at an existing directory with the “Local File” feature, which supports bulk creation through customizable regex matchers. The HTML5 player offers standard controls, episode navigation, and a Netflix‑style episode browser. An admin panel provides user management, role‑based access, and easy content editing.
Deployment
Streama runs on a Grails 3 backend with Spring Security and an AngularJS front‑end. It requires a Java runtime, a writable upload directory, and a TMDB API key. Installation is performed via the provided releases; the server can be hosted on any platform that supports Grails applications, and the UI works best in Chrome.
Highlights
Netflix‑style UI with episode browser and continue‑watch
Automatic TMDB metadata retrieval and image import
Drag‑and‑drop upload plus local directory bulk import
Admin panel for user roles, permissions, and content editing
Pros
- Familiar Netflix‑like interface reduces learning curve
- Metadata auto‑population saves manual entry time
- Supports both direct uploads and bulk local file import
- Role‑based admin panel enables multi‑user management
Considerations
- HTML5 player only officially tested in Chrome
- No built‑in video transcoding; relies on browser compatibility
- Requires a valid TMDB API key and manual configuration
- Deployment limited to Java/Grails environment
Managed products teams compare with
When teams consider Streama, these hosted platforms usually appear on the same shortlist.
Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.
Fit guide
Great for
- Home media enthusiasts wanting a private streaming hub
- Families needing separate user accounts and watch progress tracking
- Tech‑savvy users comfortable configuring a Java‑based server
- Collections with existing file structures that can be matched via regex
Not ideal when
- Users seeking out‑of‑the‑box transcoding or format conversion
- Environments without Java or Grails support
- People requiring native mobile applications
- Large‑scale commercial deployments needing enterprise support
How teams use it
Organize a personal movie library
Metadata and artwork are auto‑filled, and movies appear in a searchable catalog with continue‑watch functionality.
Stream TV series to multiple household members
Each user sees their own progress, can resume episodes, and admins can manage access rights.
Bulk import a pre‑existing collection on a NAS
Define a local directory, configure regex matcher, and Streama creates shows, seasons, and episodes automatically.
Add new releases without re‑uploading files
Drag‑and‑drop new video files or place them in the watched directory; Streama updates the library instantly.
Tech snapshot
JavaScript65%
Groovy13%
HTML9%
SCSS7%
CSS6%
Dockerfile1%
Frequently asked questions
Do I need a TMDB API key?
Yes, a valid TheMovieDatabase.org API key is required for metadata retrieval; the settings page validates it.
Which browsers are supported?
The HTML5 player has been tested primarily in Chrome; other modern browsers may work but are not officially verified.
Can Streama transcode videos?
No built‑in transcoding is provided; videos must be in a format supported by the browser.
How do I add existing files without uploading?
Use the Settings page to define a local directory, then access the Local File browser or bulk‑create feature to import files.
Is there a way to customize the file‑matching regex?
Yes, you can edit the regex patterns in `application.yml` under the `streama.regex` section.
Project at a glance
Active- Stars
- 9,807
- Watchers
- 9,807
- Forks
- 985
LicenseMIT
Repo age10 years old
Last commit2 weeks ago
Primary languageJavaScript
Last synced yesterday