youtube-to-w2g

YouTube to Watch2Gether (Y2W)

Y2W Logo **Send YouTube videos to your Watch2Gether room with a single click!** _Because copy-pasting URLs is so 2020_ 😎 [![Chrome Web Store](https://img.shields.io/badge/Chrome%20Web%20Store-Available-green?style=flat-square&logo=google-chrome)](https://chromewebstore.google.com/detail/y2w-youtube-to-watch2geth/afgajabndpahomibkdlpgejbfmlfckig) [![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](CONTRIBUTING.md) [![JavaScript](https://img.shields.io/badge/JavaScript-ES6+-yellow?style=flat-square&logo=javascript)](https://developer.mozilla.org/en-US/docs/Web/JavaScript) [![Manifest](https://img.shields.io/badge/Manifest-V3-green?style=flat-square)](https://developer.chrome.com/docs/extensions/mv3/)
Y2W Promotional Banner
Install from Chrome Web Store

📖 Why This Exists

You know that moment when you’re watching YouTube and find the perfect video to share with your friends on Watch2Gether? Yeah, me too. The whole copy URL → switch tabs → paste → hope it works thing got old real fast.

So I built Y2W – a simple Chrome extension that adds a “Y2W” button right in the YouTube player. One click and boom, your video is in the W2G room. No more tab juggling!

📋 What is Y2W?

YouTube to Watch2Gether (Y2W) is a Chrome extension that seamlessly integrates with YouTube. It’s literally just a button that does one thing really well: sends videos to your Watch2Gether room instantly.

✨ Features

🚀 Installation

🎉 Y2W is now available on the Chrome Web Store!

  1. Install Y2W from Chrome Web Store
  2. Click “Add to Chrome”
  3. The extension will be installed automatically
  4. Follow the configuration steps below

Manual Installation (Developer Mode)

  1. Download the Extension 
    git clone https://github.com/fedevgonzalez/youtube-to-w2g.git
cd youtube-to-w2g
  2. Load in Chrome
    • Open Chrome and navigate to chrome://extensions/
    • Enable Developer mode (toggle in top right)
    • Click Load unpacked
    • Select the youtube-to-w2g folder
  3. Configure Your Credentials
    • Click the Y2W extension icon in your toolbar
    • Enter your Watch2Gether API key and Room Access Key
    • Click Save Configuration

🔑 Getting Watch2Gether Credentials

API Key

  1. Visit Watch2Gether API
  2. Log in to your W2G account
  3. Navigate to the API section
  4. Generate or copy your API key

Room Access Key

  1. Create or join a W2G room
  2. Open the room settings
  3. Look for “Room Access Key” or “Room API Access”
  4. Copy the key

Pro tip: Keep these keys safer than your Netflix password. Seriously, don’t share them!

💻 Usage

Once installed and configured:

  1. Navigate to any YouTube video
  2. Look for the “Y2W” button in the video player controls
  3. Click the button to instantly send the video to your Watch2Gether room
  4. The button will show a checkmark (✓) when successful

Button States (aka The Button’s Mood Ring)

🛠️ Development

Prerequisites

Project Structure

youtube-to-w2g/
├── manifest.json         # Extension manifest (V3)
├── popup.html            # Configuration popup
├── css/                  # Styles
│   └── popup.css
├── js/                   # JavaScript files
│   ├── background.js     # Service worker
│   ├── content.js        # Content script
│   └── popup.js          # Popup logic
└── assets/               # Resource files
    ├── icons/            # Extension icons
    │   └── y2w.svg       # Source icon
    └── images/           # Promotional images

Making Changes

  1. Edit the relevant files
  2. Reload the extension in chrome://extensions/
  3. Refresh YouTube to test changes

🔧 Troubleshooting

Common Issues (aka “Halp, it’s broken!”)

“Where’s my button?!”

“Configuration Missing” (aka you forgot to set it up):

“Failed to send” (the dreaded red button):

“It worked yesterday!” syndrome:

🗺️ Roadmap

🔌 API Reference

The extension uses the Watch2Gether API v1:

Endpoint: POST https://api.w2g.tv/rooms/{roomKey}/playlists/current/playlist_items/sync_update

Headers:

{
  "Accept": "application/json",
  "Content-Type": "application/json",
  "Authorization": "Bearer {apiKey}"
}

Request Body:

{
  "w2g_api_key": "{apiKey}",
  "add_items": [{
    "url": "https://www.youtube.com/watch?v={videoId}",
    "title": "{videoTitle}"
  }]
}

🤝 Contributing

Found a bug? Have an idea? Want to make the button do a backflip? I’d love your help! Check out the Contributing Guidelines to get started.

Seriously though, this project is better with your input. Don’t be shy!

Quick Start

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

🐛 Found a Bug? Got an Idea?

First, check if someone beat you to it in the issue tracker. If not, create a new issue and let’s make Y2W better together!

I actually read these, promise. 👀

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Shoutouts

💬 Need Help?

💖 Support

If Y2W saved you some time and you want to say thanks:

Made with ❤️ (and lots of YouTube videos) by fedevgonzalez
If you're reading this, you're awesome! 🎉
This site is open source. Improve this page.