{"id":29894154,"url":"https://github.com/juxt/reco","last_synced_at":"2025-10-06T02:57:23.008Z","repository":{"id":265386600,"uuid":"879717375","full_name":"juxt/reco","owner":"juxt","description":"JUXT OBS Recording \u0026 Streaming","archived":false,"fork":false,"pushed_at":"2024-10-31T15:13:50.000Z","size":5392,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-10-01T23:39:36.543Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Lua","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/juxt.png","metadata":{"files":{"readme":"README.adoc","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-10-28T12:32:22.000Z","updated_at":"2024-11-07T21:11:19.000Z","dependencies_parsed_at":"2024-11-29T09:52:20.321Z","dependency_job_id":null,"html_url":"https://github.com/juxt/reco","commit_stats":null,"previous_names":["juxt/reco"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/juxt/reco","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Freco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Freco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Freco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Freco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juxt","download_url":"https://codeload.github.com/juxt/reco/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Freco/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278551483,"owners_count":26005389,"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","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-08-01T04:45:23.472Z","updated_at":"2025-10-06T02:57:22.981Z","avatar_url":"https://github.com/juxt.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"= reco\nBenjamin Shearlock \u003cbcs@juxt.pro\u003e\nv1.0, 2024-10-28\n:status: WORKING RECOMMENDATION\n:classification: INTERNAL\n:reader-nickname: User\n:reader-code: \u003cjuxter-code\u003e\n:reader-fullname: User\n:toc: macro\n\n== Introduction\n\nWelcome {reader-nickname}\n\n=== Objective\n\nTo document the steps to install and configure OBS Studio for streaming and/or recording using the pre-configured JUXT OBS setup.\n\ntoc::[]\n\n=== Audience\n\nThis document is intended for users who are setting up OBS Studio for the first time. It will help them configure it with the JUXT OBS package.\n\n== Procedure\n\n=== Requirements\n\n* OBS Studio Installer\n* JUXT OBS configuration package (JUXT-OBS.zip)\n\n=== OBS Installation and Setup\n\n==== Step 1: Download and Extract the JUXT OBS Package\n\n// Use Pages to link this as a direct download in the future!\nDownload the JUXT OBS zipped configuration package *link:https://juxt.github.io/reco/OBS-JUXT.zip[OBS-JUXT.zip]* and extract/unzip it to a convenient location on your system. Alternatively, you can just **Clone** this repository and navigate to the `OBS-JUXT` folder within it.\n\n==== Step 2: Install OBS Studio\n\nGo to this *link:https://obsproject.com/[link]* and download the appropriate installer for your operating system. Alternatively, you could also install OBS from your system's \"App Store\", or via a package manager.\n\nInstall OBS Studio following the usual installation process for your system.\n\n==== Step 3: Install the Font\n\nWithin the extracted folder, locate the file `InterFace_Trial_Rg.ttf`. To install the font, double-click the file and select **Install**. If your operating system requires a different method to install fonts, follow that method. This is to ensure that there is a consistent font that can work across all operating systems.\n\n==== Step 4: Launch OBS Studio and Initial Setup\n\nLaunch OBS Studio. When prompted, select whether you intend to **stream** or **record**. If you are unsure, choose **Recording** for now. Make sure the **Base Canvas Resolution** is set to `1920x1080`. Click **Next** for all other settings.\n\nNOTE: If you selected to stream, provide your Twitch or other streaming service credentials/keys when prompted. \n\nClick **Apply Settings** when finished.\n\n==== Step 5: Import Scene Collection\n\nAt the top of the OBS window, click the **Scene Collection** tab. From the dropdown, select **Import**. If prompted to confirm anything, click **Yes**.\n\nNext, in the **Collection Path** column, click the **three dots** and navigate to the folder where you extracted the JUXT OBS package. Select the file `JUXT Scenes.json` and click **Import**.\n\n==== Step 6: Add the JUXT Lua Script\n\nGo to the **Tools** tab at the top of OBS and select **Scripts**. In the bottom left, click the **+** button to add a new script. By default, you'll be taken to the default OBS scripts folder.\n\nNavigate to the extracted JUXT OBS folder and select the file `JUXT Script.lua`. It may cause some **pop-ups** to appear, please **close/click cancel** on any that do.\n\nNOTE: It may also cause OBS to crash or freeze, if so just restart it. Once OBS is running again, open the **Scripts** menu.\n\nOn the right-hand side within **Scripts**, you'll see parameters that you can adjust (such as folder selection, text inputs and dropdown lists).\n\nFor the **Folder** parameter, navigate once more to the extracted JUXT OBS folder and select it.\n\n==== Step 7: Adjust Scene Information\n\nOnce you have entered all the necessary information in the script parameters, you may want to change which screen is being displayed. To do this:\n\n1. Navigate to the **Screen** scene (Ctrl + 4).\n2. Scroll down the list of sources until you find the \"**Record Screen**\" for your operating system.\n3. Double-click it to adjust the screen/display you want to record.\n\nIf you find that **NONE** of these screens are interactable within your OBS, you may need to add a new screen capturing source. If not, **skip** this section. To do this:\n\n1. Click the **+** button in the **Sources** panel.\n2. Select the **Screen Capture** option.\n3. Name the source and click **OK**. \n4. A pop-up will appear, select the screen you want to capture and click **OK**.\n5. Depending on your screen size/resolution, you may see your screen being too large to fit in the scene. Since you should have the screen source still selected, press **Ctrl + S** to resize the screen to fit the scene.\n6. At the bottom of sources, you'll see arrows to move the source up and down. Press repeatedly on the **down** arrow until the newly created screen source is at the bottom of the list.\n7. Right-click the the newly created screen source and select **Copy**. Then navigate to the **Both** scene, right-click and select **Paste (Reference)** - this can also all be done using keyboard commands for copy \u0026 paste. \n8. Finally, refer to **Part 6** to ensure that the pasted screen source is at the bottom of the list in the **Both** scene.\n\n==== Step 8: Customize Hotkeys\n\nTo customise any hotkeys used in OBS:\n\n1. Go to **Settings** in the bottom-right corner.\n2. Select the **Hotkeys** tab from the menu on the left.\n3. Adjust hotkeys as needed.\n\nThe scene collection comes with pre-configured hotkeys for each scene, which you can use while tabbed out of OBS to swap between scenes.\n\n==== Step 9: Audio Mixer Configuration\n\nThe OBS audio mixer should automatically use your default system devices. However, if you need to use a different microphone:\n\n1. Select the **Audio Input Source** in sources.\n2. Adjust the microphone input accordingly.\n\nIn the **Audio Mixer** panel, you can adjust the volume of each source as needed.\n\nNOTE: Your microphone and computer audio will **NOT** be recorded when you are using the **Intro** and **Outro** scenes.\n\n=== Starting Your Recording or Stream\n\nTo begin streaming or recording, use the **Start Streaming** or **Start Recording** buttons located on the far right in the **Controls** panel. These can also be assigned to hotkeys.\n\n=== Further Assistance\n\nIf you encounter any issues with the installation or have further questions, please contact @bcs on Slack.\n\n== Next Steps\n\nWith OBS setup, you can customise it as needed for your streaming and recording requirements.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuxt%2Freco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuxt%2Freco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuxt%2Freco/lists"}