{"id":37349771,"url":"https://github.com/vjdev1212/byoc","last_synced_at":"2026-01-16T04:01:08.228Z","repository":{"id":331336398,"uuid":"1125851459","full_name":"vjdev1212/byoc","owner":"vjdev1212","description":"BYOC - Bring your own content, a simple and sleek frontend for your own collection of movies and TV shows.","archived":false,"fork":false,"pushed_at":"2026-01-01T13:58:33.000Z","size":4051,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-06T13:22:36.049Z","etag":null,"topics":["bring-your-own-content","byoc","movies","series","streaming","tv","tvshows"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vjdev1212.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-31T13:49:10.000Z","updated_at":"2026-01-01T13:58:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vjdev1212/byoc","commit_stats":null,"previous_names":["vjdev1212/byoc"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/vjdev1212/byoc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vjdev1212%2Fbyoc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vjdev1212%2Fbyoc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vjdev1212%2Fbyoc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vjdev1212%2Fbyoc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vjdev1212","download_url":"https://codeload.github.com/vjdev1212/byoc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vjdev1212%2Fbyoc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28477206,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T03:13:13.607Z","status":"ssl_error","status_checked_at":"2026-01-16T03:11:47.863Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bring-your-own-content","byoc","movies","series","streaming","tv","tvshows"],"created_at":"2026-01-16T04:01:07.850Z","updated_at":"2026-01-16T04:01:08.155Z","avatar_url":"https://github.com/vjdev1212.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BYOC\nBYOC - Bring your own content, a simple and sleek frontend for your own collection of movies and TV shows.\n\n## Framework\nThis app is built using the Expo React Native framework.\n\n## Prerequisites\n- Node.js and npm installed\n- Expo CLI installed (`npm install -g expo-cli`)\n- `.env` file with the required TMDB API key\n\n## Setup\n1. Clone the repository:\n   ```sh\n   git clone https://github.com/vjdev1212/byoc.git\n   cd byoc\n   ```\n2. Create a `.env` file in the project root and set the TMDB API Key:\n   ```cmd\n   EXPO_PUBLIC_TMDB_API_KEY=api_key_here\n   ```\n3. Install dependencies:\n   ```cmd\n   npm install\n   ```\n4. Start the Expo development server:\n   ```cmd\n   npx expo start\n   ```\n\n## Running on Expo Go\n- Scan the QR code from the Expo CLI output using the Expo Go app on your mobile device.\n\n## Stopping the Development Server\nTo stop the running process, press `Ctrl + C` in the terminal.\n\n## URL Templates\n\nBYOC allows you to use your own streaming service with your own custom backend. The app is flexible and only requires specific metadata to fetch streams.\n\n### Required Information\n\nThe app needs the following information to fetch streams:\n\n**For Movies:**\n- IMDB ID or TMDB ID\n\n**For TV Shows:**\n- IMDB ID or TMDB ID\n- Season number\n- Episode number\n\n### Template Configuration\n\nURL templates can be configured in **Settings \u003e Template Settings**. You need to provide two templates:\n\n1. **Movie Template** - URL format for fetching movie streams\n2. **TV Show Template** - URL format for fetching TV show streams\n\n### Template Placeholders\n\nUse the following placeholders in your templates:\n\n- `{IMDBID}` - IMDB identifier (e.g., tt1234567)\n- `{TMDBID}` - TMDB identifier (e.g., 12345)\n- `{SEASON}` - Season number (required for TV shows)\n- `{EPISODE}` - Episode number (required for TV shows)\n\n**Important:** The TV show template must include `{SEASON}` and `{EPISODE}` placeholders, otherwise it will not work. These parameters are not required for movie templates.\n\n### Example Templates\n\n**Movies:**\n```\nhttps://example.com/stream/movie/{IMDBID}\n```\n\n**TV Shows:**\n```\nhttps://example.com/stream/tv/{IMDBID}/{SEASON}/{EPISODE}\n```\n\n### Using Stremio Addons\n\nYou can use any Stremio addon that follows the standard manifest format. Example with Torrentio:\n\n**Movies:**\n```\nhttps://nuviostreams.hayd.uk/stream/movie/{IMDBID}.json\n```\n\n**TV Shows:**\n```\nhttps://tnuviostreams.hayd.uk/stream/series/{IMDBID}:{SEASON}:{EPISODE}.json\n```\n\n### Required Response Format\n\nYour service or addon must return a JSON response in the following format:\n\n```json\n{\n  \"streams\": [\n    {\n      \"name\": \"Provider Name\\nQuality Info\",\n      \"title\": \"Stream Title with Details\\nAdditional metadata\",\n      \"url\": \"https://example.com/stream/video.mp4\"\n    },\n    {\n      \"name\": \"Provider Name\\nQuality Info\",\n      \"title\": \"Another Stream Title\\nMore details\",\n      \"url\": \"https://example.com/stream/video2.mkv\"\n    }\n  ]\n}\n```\n\n**Response Structure:**\n- `streams` (array, required) - Array of available streams\n  - `name` (string, optional) - Display name and quality information\n  - `title` (string, optional) - Stream title with additional details\n  - `url` (string, required) - Direct URL to the video stream\n\n**Note:** Each stream object must include a `url` field pointing to a playable video stream (MP4, MKV, etc.).\n\n### Creating Your Own Service\n\nTo create your own streaming service compatible with BYOC:\n\n1. Set up an API endpoint that accepts IMDB/TMDB IDs\n2. For TV shows, ensure it also accepts season and episode parameters\n3. Return the response in the exact JSON format shown above\n4. Host your service and configure the template URL in the app\n\nThe service should:\n- Accept GET requests\n- Return valid JSON\n- Include the `streams` array with a valid `url` field for each stream\n- Handle both movie and TV show requests appropriately\n- Provide direct streaming URLs (MP4, MKV, or other supported video formats)\n\n## Screenshots\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/vjdev1212/byoc/refs/heads/main/byoc-screenshots/iPhone/1-Home%20Screen.png\" width=\"18%\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/vjdev1212/byoc/refs/heads/main/byoc-screenshots/iPhone/2-Movie-Details.png\" width=\"18%\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/vjdev1212/byoc/refs/heads/main/byoc-screenshots/iPhone/3-TV-Details.png\" width=\"18%\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/vjdev1212/byoc/refs/heads/main/byoc-screenshots/iPhone/4-Search.png\" width=\"18%\" /\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/vjdev1212/byoc/refs/heads/main/byoc-screenshots/iPhone/5-Carousel.png\" width=\"18%\" /\u003e  \n\u003c/p\u003e\n\n## LICENSE\nLicensed under the GNU General Public License v3.0 (GPL-3.0).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvjdev1212%2Fbyoc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvjdev1212%2Fbyoc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvjdev1212%2Fbyoc/lists"}