# Chrome Extension Installation Guide

This guide explains how to install the **JaTubePlayer Chrome Extension**

> ⚠️ This extension is installed in **Developer mode**.
> Chrome may show warnings — this is expected.

---

## 1. Download the extension

1. Go to the **Releases** page of this repository.
2. Locate the release with tag **`V2.0`**.
3. Download the file:`chrome_extension.7z`

---

## 2. Extract the archive

1. Use an archive tool such as **7-Zip** or **WinRAR**.
2. Extract `chrome_extension.7z` to a folder of your choice.

After extraction, the folder **must contain**:
- `manifest.json`
- `chrome_test.js`
- other extension files

> ⚠️ **Do not delete or move this folder after installation.**
> Chrome loads the extension directly from this location.

---

## 3. Open the Chrome Extensions page

1. Open **Google Chrome**
2. In the address bar, navigate to:`chrome://extensions`
3. Enable **Developer mode** (top-right corner).

---

## 4. Load the extension

1. Click **Load unpacked**
2. Select the **extracted folder** (the one containing `manifest.json`)
3. Confirm

The `JaTubePlayer Chrome Extension` should now appear in your extensions list.

---

## 5. Verify the extension

- Right-click on a **YouTube video**
- You should see a context menu entry:

🎬 Send to JTP

If the menu item appears, the extension is installed correctly.

---

## Updating the extension

To update to a newer version:
1. Download the new `chrome_extension.7z` from the latest release if available
3. Replace the contents of the existing extracted folder
4. Go to `chrome://extensions`
5. Click **Reload** on the extension

---

## Troubleshooting

### Extension does not appear
- Make sure **Developer mode** is enabled
- Ensure the selected folder contains `manifest.json`

### Context menu does not show on YouTube
- Confirm the page URL starts with `https://www.youtube.com/`
- Refresh the page after installing the extension

---

## Notes

- This extension communicates with a local or remote JaTubePlayer backend
- If the backend is not running or unreachable, error notifications may appear
- Network permissions are restricted to the configured backend endpoint