KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#codex #developer-tools #typescript #ai-agents #claude-code #python #mcp #react #cli #macos #ai-agent #deepseek-harness

youtube-cast-receiver

★ 109 Open GitHub ↗

Grants access to youtube.com/tv normally reserved for use with smart TVs

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Youtube Cast Receiver (YCR)
> Cast Youtube videos to ANY computer, no chromecast needed!

![](https://img.shields.io/badge/platform-linux--64%20%7C%20osx--64%20%7C%20win--64-green)
![](https://img.shields.io/badge/node%40latest-%3E%3D%206.0.0-green)
![](https://img.shields.io/badge/license-GPL-green)

![](https://github.com/GarrettBlackmon/youtube-cast-receiver/blob/master/assets/icon.png?raw=true)

Youtube Cast Receiver (YCR) was built to allow you to cast Youtube content from your phone directly to your computer. This is very useful while traveling with a laptop and hdmi cable. Leave the chromecast at home!

This is achieved by spoofing the useragent to make your connection appear to come from a smart TV, allowing you to access [youtube.com/tv](https://youtube.com/tv). This app launches in fullscreen mode to give you an immersive and native feeling casting experience.

## Installation

Grab the appropriate binary for your system from the [releases](https://github.com/GarrettBlackmon/youtube-cast-receiver/releases/) page.

On Linux there are a few options. The AppImage is the one to grab if you're not sure - it runs anywhere, no install needed:

```sh
chmod +x youtube-cast-receiver-*.AppImage
./youtube-cast-receiver-*.AppImage
```

AppImages need FUSE 2. Most distros still ship it, but if you get a `libfuse.so.2` error either install it (`fuse2` on Arch, `libfuse2` on Debian/Ubuntu) or just run the file with `--appimage-extract-and-run`.

If you'd rather have it show up in your app menu like a normal program, there's a `.deb`, an `.rpm`, and a `.pacman` for Arch (`sudo pacman -U youtube-cast-receiver-*.pacman`).

## Linking your device

### 1: Open the application and click the settings icon

![step1](https://i.imgur.com/WLl57WN.png)

### 2: Click "LINK WITH TV CODE"

![step2](https://i.imgur.com/J0Awy33.png)

### 3: Note the TV code on your screen

![step3](https://i.imgur.com/bhmCurr.png)

### 4: Open the Youtube app on your smartphone and click your photo in the top right
<img src="https://i.imgur.com/wcA32XI.png" height="500px">

### 5: Tap "Settings"
<img src="https://i.imgur.com/wcA32XI.png" height="500px">

### 6: Tap "Watch on TV"
<img src="https://i.imgur.com/TrBpOjk.png" height="500px">

### 7: Tap "Enter TV code"
<img src="https://i.imgur.com/2kEBacS.png" height="500px">

### 8: Enter the code on your computer screen in the box and press "Link"
<img src="https://i.imgur.com/gCKYXlz.png" height="500px">

## Release History

* 0.1.0
    * Work in progress - compiled for Linux/MacOS
* 1.0.0
    * Official release - compiled for Windows/MacOS/Linux
* 1.0.1
    * Bugfix - removed menubar on windows distribution
* 1.0.2
    * Electron 12 -> 43, fixed the build pipeline, added AppImage/rpm/pacman builds for Linux

## Contributing

1. Fork it (<https://github.com/yourname/yourproject/fork>)
2. Create your feature branch (`git checkout -b feature/fooBar`)
3. Commit your changes (`git commit -am 'Add some fooBar'`)
4. Push to the branch (`git push origin feature/fooBar`)
5. Create a new Pull Request

## Development

To run the project locally with npm:

```sh
git clone https://github.com/GarrettBlackmon/youtube-cast-receiver
npm i
npm run start
```

To build for your own platform:

```sh
npx electron-builder --linux    # or --mac / --windows
```

Builds land in `dist/`. `npm run build-local` does all three at once, but cross-building mac and windows off their own OS needs extra tooling, so CI handles that.

## Meta

Garrett Blackmon – [@GarrettBlackmon](https://twitter.com/garrettblackmon) – garrett@blackmon.dev

Distributed under the GPL license.

youtube-cast-receiver

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README