Help Center

Frequently Asked Questions

Choosing between the three products, supported platforms, installation troubleshooting, Cookies and remote download — the most common questions about SaveXTube, all in one place.

Products & Choosing

Not sure which one to install? Start with these three.

What's the difference between SaveXTube Desktop, Server and Client?

All three share the same download engine. The difference is where they run and who executes the jobs:

SaveXTube Desktop: a local tool for Mac and Windows. Downloading, speech-to-text, and AI organization all happen on your machine, and files land directly on that computer's disk.

SaveXTube Server: a download hub that runs around the clock on a NAS or server. Your phone, computer, WeChat, and Telegram hand links to it; the device does the downloading on its own, media lands in shared storage, and the web dashboard shows progress anytime.

SaveXTube Client: a pocket entry point for phones and tablets. It only submits jobs and shows progress — it doesn't download anything itself and takes up no phone storage.

Which product does the Client work with? Can it connect to Desktop directly?

The Client only works with SaveXTube Server — connecting to SaveXTube Desktop is not supported. The Server handles all downloading and storage; the Client just submits jobs and checks progress from your phone, so you need a running Server first.

If you only have one computer and no always-on device, Desktop alone is enough. To toss links in remotely from your phone, you can use Desktop's WeChat remote, Telegram Bot, or HTTP API — no Client needed.

Which of the three products should I install?

Just a Mac or Windows PC: install Desktop — local downloading, transcription, and organization in one app.

A NAS or always-on server: install Server and let the device download on its own, with media going straight into shared storage.

Want to start downloads from your phone: Server + Client — Server does the work, Client is the entry point.

All three can coexist: Desktop for the computer in front of you, Server for the always-on device, Client for your phone.

General

Platforms, quality, connectivity, and licensing — shared by all three products.

Which platforms does SaveXTube support?

YouTube, X, Douyin, Xiaohongshu (RedNote), Bilibili, WeChat Channels, Instagram, Facebook, Telegram, and more — anything covered by yt-dlp and gallery-dl. Availability may change as platform rules evolve.

Which image sites are supported?

Currently supported: ZCOOL works, Xiaohongshu (RedNote) photo notes, Instagram albums, Telegraph pages, and images in X posts. Multi-image content is downloaded in batch when the source provides the files. Content behind a login, private, or restricted may require the platform's Cookies first. Availability may be temporarily affected when platform pages or APIs change.

Why can't Weibo videos be downloaded without the watermark?

Some Weibo videos have the watermark burned into the picture by Weibo's own transcoding/distribution pipeline. SaveXTube downloads the MP4 or M3U8 streams Weibo actually provides, so a watermark-free version cannot be restored from a feed that already has it baked in. Whether a watermark-free source exists depends on Weibo offering the author's original file or another un-watermarked media variant.

How do I download Telegram videos?

Downloading videos from Telegram channels, groups, or chats requires a Telegram user session first. Open Telegram's official API development tools, sign in with your own Telegram phone number, create an application, and copy the API ID and API Hash from the page.

In SaveXTube, open "Settings → Cookies → Telegram", fill in the API ID, API Hash, and phone number, then click "Send code". Enter the code you receive in Telegram. If two-step verification is enabled, you'll also need your 2FA password. Once verified, paste any https://t.me/... message link into SaveXTube to download it. For private channels or groups, that Telegram account must have joined and have access.

A Bot Token is only for Telegram Bot remote control — it can't replace the API ID, API Hash, and user session. The API Hash and generated Session are sensitive credentials: keep them on your own computer and never share them.

How do I download WeChat Channels videos?

SaveXTube resolves WeChat Channels download URLs through Tencent Yuanbao, so a valid Tencent Yuanbao web Cookies is required. First open and sign in to Tencent Yuanbao in Chrome or Edge, then use the Get cookies.txt LOCALLY extension to export Netscape-format Cookies. In SaveXTube, open "Settings → Cookies", choose "Channels", paste the Cookies, and save. After that, paste a WeChat Channels share link to start downloading. Cookies are stored locally only — never send them to anyone.

Is 4K or higher quality supported?

Available quality and formats depend on the source site and your login state (Cookies) — some platforms only unlock higher quality or specific formats when signed in. When the site offers the option, SaveXTube automatically picks the best video and audio streams and merges them.

Does it need an internet connection?

Downloading and calling online AI services need internet. Managing downloaded files, local transcription, and some organizing features run offline.

Can downloaded videos be used commercially?

Please only download content you have the right to access and keep, and respect copyright, platform terms, and local law.

Where can I get help?

Start by searching this page — most installation, platform, and Cookies questions are covered here. If you can't find an answer, join our official QQ group (group number 908769885, or join via the share link). It has both Mac / Windows desktop users and self-hosters running SaveXTube Server on a NAS — replies usually come within minutes.

When asking, include your OS version, SaveXTube version, what you were trying to do, and the exact error message (screenshots or logs help a lot). Mask sensitive info such as API keys, Cookies, and Telegram Sessions first.

Can one license be used on multiple computers?

Yes. Each personal license can be activated on up to 3 personal computers, so you can use SaveXTube across your everyday machines.

Desktop

Installation, troubleshooting, and local features for the Mac & Windows app.

macOS says "Apple cannot verify SaveXTube Desktop" — what do I do?

This is a macOS Gatekeeper notice. The current installer on this site uses an ad-hoc signature and hasn't completed Apple notarization yet; after downloading from a browser the file also carries a quarantine flag, so the system can't confirm the developer and notarization status. The notice means "Apple cannot verify" — it does not mean macOS detected malware. Only perform the steps below on an app downloaded from the official SaveXTube site.

Option 1: the macOS Assistant
In the macOS Assistant you trust, choose "Bypass signature" and process SaveXTube Desktop.app only. Do not disable Gatekeeper globally.

Option 2: Terminal command
First drag the app into the "Applications" folder, then open Terminal and run:

sudo xattr -rd com.apple.quarantine "/Applications/SaveXTube Desktop.app"

Enter your Mac login password and reopen the app. The terminal shows no characters while typing the password — that's normal.

Windows shows "The procedure entry point PowerUnregisterFromEffectivePowerModeNotifications could not be located" after installation — what do I do?

This usually isn't a broken installer — your Windows version is older than what the app requires. The WinUI 3 / Windows App SDK used by SaveXTube supports Windows 10 1809 (OS Build 17763) at minimum; earlier versions lack the system APIs the runtime needs. Run winver in PowerShell or the Run dialog to check your version and OS build, and confirm you're on at least Windows 10 1809 / Build 17763. If not, update via Windows Update first — Windows 10 22H2 or Windows 11 is recommended.

How do I use the floating download ball, DIY skins, and the Codex pet?

In SaveXTube's "Settings → Floating Download", choose the default download ball or a Codex pet as your desktop download entry: drag a browser link onto the floating entry to download; after copying a URL, right-click to create a job instantly, and left-click to open the main window. To change the app's look, grab a community skin from SaveXTube Skins; to design your own, use the SaveXTube Skin Builder Skill; to build a desktop pet of your own, use the Codex Pet Builder Skill. SaveXTube can also install pets from codex-pet.org page links or ZIP files, and discovers pets installed by local Codex in read-only mode. Skins, Skills, and the pet directory are community resources; codex-pet.org is not an official OpenAI service, and SaveXTube neither preinstalls nor redistributes third-party pets from it.

How accurate are subtitles and transcription?

Accuracy mainly depends on the model you choose. SaveXTube supports both local and cloud models: local models run fully offline with better privacy; cloud models are usually more accurate on complex material. Switch freely based on your needs.

How do I turn a video or audio file into text?

Open SaveXTube's "Settings → AI Models → Speech-to-Text" and choose local MLX / Whisper, Alibaba Cloud Bailian, or an OpenAI-compatible service. For a local engine, install and check the model as prompted; for a cloud service, fill in the API key, model, and other details and save. Then go to the "Files" page, find the downloaded video or audio, click the transcribe button or choose "Start Transcription / Speech-to-Text" from the right-click menu. When it finishes, read the full transcript in "Smart Analysis" and save it as Markdown if needed.

How do I generate an AI summary?

An AI summary requires that the video or audio has already been transcribed. In "Settings → AI Models → Language Model", configure and test an available LLM — OpenAI, DeepSeek, Qwen, a local Ollama model, or other compatible services. Back on the "Files" page, right-click the file and choose "Generate AI Summary", or open "Smart Analysis" first and click generate there. Summaries are saved with the smart analysis results and can be exported as Markdown. When using a cloud LLM, the transcript is sent to the chosen provider for processing.

How do I create a mind map from a video?

A mind map also needs an existing transcript and a configured language model. After transcribing and saving/testing an LLM in "Settings → AI Models → Language Model", go to the "Files" page, right-click the file and choose "Generate Mind Map", or click generate inside the "Smart Analysis" window. SaveXTube turns the transcript into a hierarchy you can preview right away and save as an XMind file; supported versions can also zoom in and export a JPG.

How do I set up MCP so an AI agent can drive SaveXTube?

Open SaveXTube's "Settings → Remote Control" and enable the MCP service; the HTTP API turns on automatically alongside it. Click "Copy Agent Config" and paste the JSON into an AI agent that supports remote HTTP MCP, then restart or refresh the agent. The config already includes the MCP endpoint and Bearer API key; once connected, the agent can submit links, query progress, and read recent jobs. The default endpoint is local-only. To connect from another device, enable LAN access only on a trusted network such as your LAN or Tailscale — never expose the port publicly or leak the API key.

Remote Download

Hand links to SaveXTube from your phone, WeChat, or Telegram — both Desktop and Server support it.

How do I download via WeChat?

In SaveXTube, open the WeChat bot, scan the QR code with WeChat on your phone, and confirm login. Once linked, just send a supported link to WeChat. SaveXTube must be running on your computer.

What are the limits on files sent back through WeChat?

Keep each returned file under 1GB. Both videos and files are limited to one return every 30 seconds — don't send several in a row within 30 seconds. For large or batch files, process them in batches; if a return fails, retry later or download locally instead.

How do I download with an iPhone or iPad Shortcut?

First enable the HTTP API in SaveXTube's "Settings → Remote Control". For phone connections also enable "Allow LAN access", and note your computer's address, port, and API key. Then install the SaveXTube Shortcut and fill in those details as prompted. In use, pick the Shortcut from the share menu in your phone's browser or other apps, or copy a video link and run it directly. SaveXTube on your computer must stay running. Phone and computer should be on the same trusted network; away from home, connect through a secure network such as Tailscale and never expose the HTTP API port to the public internet.

What can Telegram remote download do?

After configuring a Bot Token and the allowed Telegram users, you can send single or batch links, check run status, watch live download progress, and have finished files sent back to Telegram per your settings.

Cookies & Login

Content behind a login — Cookies unlock the full quality.

How do I export and fill in platform Cookies?

We recommend the Chrome / Edge extension Get cookies.txt LOCALLY. Open the platform you want to download from and sign in, click the extension icon in the toolbar, make sure Export Format is Netscape, then click Copy. In SaveXTube, open "Settings → Cookies", pick the platform, paste the content into the Cookies editor, and save. Cookies represent your login state — treat them like passwords and never share them.

Why does downloading stop working a while after I configure Cookies?

Cookies are temporary credentials platforms use to recognize your login. They all expire, and may die early if you sign out, change your password, or the platform's security policy kicks in — SaveXTube cannot extend their lifetime. If downloads worked before but now report login or parsing failures, sign in to the platform again in your browser (WeChat Channels requires signing in to Tencent Yuanbao again), re-export fresh Netscape-format Cookies, overwrite the old ones for that platform in SaveXTube, save, and retry.