{"id":49929054,"url":"https://github.com/realwhyknot/parseccouchlink","last_synced_at":"2026-05-31T00:00:57.060Z","repository":{"id":358358634,"uuid":"1239656044","full_name":"RealWhyKnot/ParsecCouchLink","owner":"RealWhyKnot","description":"Parsec remote couch bridge for retro consoles","archived":false,"fork":false,"pushed_at":"2026-05-30T23:03:46.000Z","size":389,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-30T23:20:31.632Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/RealWhyKnot.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":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-15T10:01:12.000Z","updated_at":"2026-05-30T23:03:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"a369becc-2f6a-459d-a8ef-9d9235e184f9","html_url":"https://github.com/RealWhyKnot/ParsecCouchLink","commit_stats":null,"previous_names":["realwhyknot/parseccouchlink"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/RealWhyKnot/ParsecCouchLink","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RealWhyKnot%2FParsecCouchLink","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RealWhyKnot%2FParsecCouchLink/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RealWhyKnot%2FParsecCouchLink/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RealWhyKnot%2FParsecCouchLink/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RealWhyKnot","download_url":"https://codeload.github.com/RealWhyKnot/ParsecCouchLink/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RealWhyKnot%2FParsecCouchLink/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33714033,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"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":"2026-05-17T02:17:49.592Z","updated_at":"2026-05-31T00:00:57.046Z","avatar_url":"https://github.com/RealWhyKnot.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Parsec CouchLink\n\nParsec CouchLink lets a remote Parsec player use a real retro console as player 2.\n\nThe Windows host reads the Parsec virtual Xbox controller, sends the button state over Wi-Fi, and a Raspberry Pi Pico 2 W or Pico W presents that input as a wired Xbox 360 controller to a USB-to-console adapter such as USB4MAPLE.\n\n**[Wiki](https://github.com/RealWhyKnot/ParsecCouchLink/wiki)** | **[Quick Start](https://github.com/RealWhyKnot/ParsecCouchLink/wiki/Quick-Start)** | **[Troubleshooting](https://github.com/RealWhyKnot/ParsecCouchLink/wiki/Troubleshooting)**\n\n## What You Need\n\n- Windows 10/11 PC running Parsec\n- One of these Pico boards:\n  - Raspberry Pi Pico 2 W (RP2350 + Wi-Fi)  -- the default target, ~$7\n  - Raspberry Pi Pico W or Pico WH (RP2040 + Wi-Fi)  -- also fully supported, ~$5-6\n- Micro-USB data cable\n- 2.4 GHz Wi-Fi name and password (both boards use a 2.4 GHz-only radio)\n- USB4MAPLE or another USB-to-console adapter that accepts a wired Xbox 360 controller\n- The console and controller adapter you want to use\n\n## Quick Start\n\n1. Download the latest `ParsecCouchLink-v*.zip` from Releases.\n2. Extract the whole zip to a normal folder, such as `Downloads` or `C:\\Tools\\ParsecCouchLink`.\n3. Open PowerShell in the extracted folder.\n4. Run:\n\n   ```powershell\n   powershell -ExecutionPolicy Bypass -File .\\setup.ps1\n   ```\n\n5. Follow the prompts. The script flashes the Pico, provisions Wi-Fi, checks that the PC can find it, and can add `couchlink.exe` to Windows startup. No controller is needed for setup.\n\nAfter setup, have the remote player join through Parsec, run `couchlink.exe`, and choose **Start streaming**. The bridge sends their gamepad to the Pico, and the console sees the Pico as a wired controller.\n\n## Release Contents\n\n| File | Purpose |\n|---|---|\n| `setup.ps1` | First-run setup script. Start here. |\n| `couchlink.exe` | Windows bridge. Runs at logon or manually. |\n| `couchlink-pico2w.uf2` | Firmware for the Pico 2 W (RP2350). |\n| `couchlink-picow.uf2` | Firmware for the Pico W / Pico WH (RP2040). |\n| `doctor.ps1`, `bundle.ps1`, `logs.ps1`, `flash.ps1`, `configure-wifi.ps1` | Convenience wrappers for common support and maintenance commands. |\n| `README.txt` | Short release-folder instructions. |\n| `LICENSE` / `NOTICE` | License text and release archive notes. |\n\nSetup detects which Pico you have at BOOTSEL time and uses the matching UF2 automatically. Only one of the two firmware files is written to your Pico.\n\n## Daily Use\n\nIf you accepted the startup shortcut during setup, sign into Windows and leave the bridge running. If not, run `couchlink.exe` before the Parsec session starts.\n\nUseful commands:\n\n```powershell\n.\\couchlink.exe doctor\n.\\couchlink.exe logs --tail\n.\\couchlink.exe configure-wifi\n.\\couchlink.exe test discover --ip 192.168.50.4\n.\\couchlink.exe test usb --all\n.\\couchlink.exe bundle\n```\n\n## Reporting bugs\n\nIf something went wrong, the fastest path is:\n\n1. `.\\couchlink.exe bundle`\n2. Open an issue at \u003chttps://github.com/RealWhyKnot/ParsecCouchLink/issues\u003e\n3. Fill in the form and drag the generated ZIP into the comment box.\n\nThe bundle contains logs, doctor output, and firmware diagnostics when\nthe Pico is reachable. It does NOT contain your Wi-Fi password.\n\nIf the bridge won't run at all, the setup transcript at\n`%LOCALAPPDATA%\\ParsecCouchLink\\data\\logs\\setup-*.log` is the next-best\nthing -- attach that instead.\n\nSee the wiki's [Reporting-Bugs](https://github.com/RealWhyKnot/ParsecCouchLink/wiki/Reporting-Bugs)\npage for the full version.\n\n## Source Layout\n\n- `bridge/` - Rust Windows bridge and setup wizard.\n- `pico-bridge/` - Pico firmware.\n- `setup.ps1` - release entrypoint for first-run setup.\n- `doctor.ps1`, `bundle.ps1`, `logs.ps1`, `flash.ps1`, `configure-wifi.ps1` - release-folder command wrappers.\n- `build.ps1` - local build and release zip staging.\n- `wiki/` - source-controlled GitHub Wiki pages.\n\nThe project is pre-release. Runtime protocol v1 and setup protocol v1 are documented in the [Protocol](wiki/Protocol.md) wiki page.\n\n## License\n\nLicensed under the GNU General Public License v3.0 or later. See [LICENSE](LICENSE) for the full text and [NOTICE](NOTICE) for release archive notes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frealwhyknot%2Fparseccouchlink","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frealwhyknot%2Fparseccouchlink","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frealwhyknot%2Fparseccouchlink/lists"}