{"id":22646678,"url":"https://github.com/suppliedorange/greenscreen-subtitles","last_synced_at":"2026-04-12T16:03:42.700Z","repository":{"id":226129977,"uuid":"767820139","full_name":"SuppliedOrange/greenscreen-subtitles","owner":"SuppliedOrange","description":"a website/electron app for displaying subtitles/text on a green-screen","archived":false,"fork":false,"pushed_at":"2024-07-18T11:44:53.000Z","size":83,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T17:53:52.507Z","etag":null,"topics":["chroma-key","chromakey","electron","green-screen","greenscreen","obs-studio","subtitles"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SuppliedOrange.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-03-06T00:24:41.000Z","updated_at":"2024-07-18T11:45:43.000Z","dependencies_parsed_at":"2024-03-10T11:41:52.899Z","dependency_job_id":null,"html_url":"https://github.com/SuppliedOrange/greenscreen-subtitles","commit_stats":null,"previous_names":["suppliedorange/greenscreen-subtitles"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuppliedOrange%2Fgreenscreen-subtitles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuppliedOrange%2Fgreenscreen-subtitles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuppliedOrange%2Fgreenscreen-subtitles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuppliedOrange%2Fgreenscreen-subtitles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SuppliedOrange","download_url":"https://codeload.github.com/SuppliedOrange/greenscreen-subtitles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246150411,"owners_count":20731419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["chroma-key","chromakey","electron","green-screen","greenscreen","obs-studio","subtitles"],"created_at":"2024-12-09T07:26:36.192Z","updated_at":"2025-10-08T18:26:02.448Z","avatar_url":"https://github.com/SuppliedOrange.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Branches\n### \u003ci\u003e [Electron Branch](https://github.com/SuppliedOrange/greenscreen-subtitles/tree/main): Launches an electron app (for window captures) \u003c/i\u003e\n^ You are here\n### \u003ci\u003e [Website with websockets branch](https://github.com/SuppliedOrange/greenscreen-subtitles/tree/websocket): Initializes as a website with websockets (for browser sources) \u003c/i\u003e\n\n# Green Screen Subtitles on Electron\nThis hosts an electron app on your pc with a green screen and subtitles/any text that be updated via an endpoint.\n\n# My use case:\n![ezgif-7-0bbbd241f6](https://github.com/SuppliedOrange/greenscreen-subtitles/assets/70258998/8a7b4ea1-17e9-41c5-95b6-03fb645961a1)\n![NVIDIA_Share_gji0puXL50](https://github.com/SuppliedOrange/greenscreen-subtitles/assets/70258998/7b8f415f-6359-42e1-90de-5568d498821e)\n![image](https://github.com/SuppliedOrange/greenscreen-subtitles/assets/70258998/12f29517-7e28-4574-9264-24e2185fb4e8)\n\n\nBackup Links of media resources: [1](https://i.imgur.com/l0cxH8c.gif) [2](https://i.imgur.com/3twdxFe.gif) [3](https://i.imgur.com/rBfbTGR.gif)\n\nI use this on OBS for streaming with a chroma key. My speech is converted to text and is sent to this app.\n\n# How to build:\n+ Download the repo, run `npm install` in the directory. \u003cbr\u003e\n+ Run `npm install electron -g` and install electron globally. \u003cbr\u003e\n+ Run `electron .` or `npm start` in the directory to start the server.\n\n# How to use: \nSend a request to `http://127.0.0.1:4999/update_subtitles` with a post request in the form of\n```json\nJSON\n{ \"text\": \"Your text here\" }\n```\n\n# Example usage\nThis is how I do it in python:\n```py\nimport requests\nurl = 'http://127.0.0.1:4999/update_subtitles'\ntry: \n    res = requests.post( url, json={ 'text': text } )\n    res = res.json()\n\n    try:\n        if res[\"success\"]: print(\"Finish!\")\n        else: print(res[\"error\"])\n\n    except Exception as e: print(\"Error while reading data recieved from server\\n\" + str(e))\n\nexcept requests.ConnectionError: print( \"Could not connect to subtitle server. Is the server running?\" )\nexcept Exception as e: print(\"Could not establish connection with subtitle server\\n\" + str(e))\n```\nUse `setter.py` included with the repo to have a cli-based interface specifically for this.\n+ `setter.py -t \"new text\"` updates the text with your args\n+ `setter.py -u` runs in interactive mode\n\n# OBS\nChoose window capture and capture the electron app (should show up as `[electron.exe]: Electron`)\nGo to filters and enable chroma key and crop/pad the top by 24.\nIt should work as intended.\n![image](https://github.com/SuppliedOrange/greenscreen-subtitles/assets/70258998/cfbb6717-8ce9-4aaf-8cd4-14fdd02923a1)\n\n## Notes:\nI made this for myself, for my specific use case- which means you may encounter problems. Make an [issue](https://github.com/SuppliedOrange/greenscreen-subtitles/issues/new) if you run into problems along with your device info\u003cbr\u003e\nYou may also simply use text files instead of this method unless you want the freedom to use effects on your texts\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuppliedorange%2Fgreenscreen-subtitles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuppliedorange%2Fgreenscreen-subtitles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuppliedorange%2Fgreenscreen-subtitles/lists"}