Files
wehub-resource-sync d18ada4ee7
Docker Publish / docker (web, apps/web/Dockerfile, web) (push) Failing after 0s
Docker Publish / docker (api, apps/api/Dockerfile, api) (push) Failing after 1s
Publish Extension / detect-version (push) Has been skipped
Publish Extension / submit (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:24:41 +08:00

100 lines
4.1 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Cookies
description: Signed-in downloads, restricted content, and cookie setup
---
Cookies reuse your browser's signed-in session so VidBee can download content that requires login or verification, such as subscriber-only items, age-gated pages, or private links.
If you see a message like **"Sign in to confirm you're not a bot"** or "login required," you need cookies.
![Error message prompting to sign in](/cookies/cookies-error-sign-in.png)
## When you need cookies
- Content that requires an account to view or download.
- Age-gated or region-locked pages.
- Private links or lists visible only to signed-in users.
- “Sign in to confirm youre not a bot” or similar verification prompts.
## Two ways to use cookies in VidBee
### Option 1: Read cookies from your browser
In **Settings**, select your browser. VidBee will try to detect the browser profile path automatically. You can also enter the profile path manually.
![Select browser for cookies](/cookies/cookies-settings-select-browser.png)
**Supported browsers (platform dependent):**
- **Windows: Firefox only. Other browsers cannot be used for cookie reading.**
- macOS: All browsers supported.
- Linux: All browsers supported.
**Steps:**
1. Sign in to the site in your browser first.
2. Open VidBee → Settings → Cookies.
3. Select a browser and confirm the profile path.
4. Go back and start the download again.
If detection fails or the path is invalid, manually choose the actual browser profile directory.
On Windows, if you are not using Firefox, switch to the cookies file method.
### Option 2: Import a cookies file
You can import a cookies file. This is useful when reading the browser profile is not possible, such as using non-Firefox browsers on Windows.
![Cookies file settings](/cookies-file.png)
**Steps:**
1. **Export cookies using a browser extension**
Choose one of these recommended extensions:
- **Chrome/Edge:** [Get cookies.txt LOCALLY](https://chrome.google.com/webstore/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)
- **Firefox:** [cookies.txt](https://addons.mozilla.org/en-US/firefox/addon/cookies-txt/)
> **Security note:** Only install the extensions recommended above. If you previously installed "Get cookies.txt" (not "LOCALLY"), uninstall it immediately. That version has been reported as malware.
2. **Export your cookies**
Click the export button in the extension and choose where to save the file. The extension will automatically export the cookies in **Netscape format**.
3. **Import to VidBee**
- Open VidBee → Settings → Cookies file
- Click Select file and choose the exported cookies file
- Refresh the download page when done
4. **Remove the cookies file**
Click Clear to disable it anytime.
## Recommendations
- Prefer browser-based cookies when possible, because it's easier to maintain.
- If browser reading fails, switch to a cookies file.
- Cookies files expire. Re-export when your account state changes.
## Troubleshooting
**Browser-based method:**
- **Profile path is invalid**: Ensure the folder exists and points to the real browser profile directory.
- **Browser read failed**: Close the browser and retry, or switch to a cookies file method.
**Cookies file method:**
- **Still asks for login**: Verify your browser is signed into the account. If signed in, ensure the exported cookies file is complete and properly formatted.
- **Export extension not working**: Make sure you installed the recommended extension version. Some outdated or unauthorized versions may not work properly.
- **Cookies file expired**: If unused for a long time, your login session may have expired. Sign in again in your browser and export a new cookies file.
- **HTTP Error 400**: This usually indicates a file format issue. Ensure the file is in standard Netscape format with correct encoding.
## Learn more
- [yt-dlp cookies FAQ](https://github.com/yt-dlp/yt-dlp/wiki/FAQ#how-do-i-pass-cookies-to-yt-dlp)
## Privacy and security
Cookies are equivalent to your login session. Keep them private and never share or upload them. If you suspect leakage, sign out and change your password.