# Bilibili · OmniGet Docs

- URL: https://getomniget.com/docs/bilibili
- Updated: 2026-10-02
- OmniGet 1.0.0

> Free, open-source yt-dlp GUI for Windows, macOS and Linux. Paste a link to save video, audio and files from 1,000+ sites, or run AI coding agents.

---

Download

# Bilibili

OmniGet has its own Bilibili handler. With your account signed in, it reads every quality your account can play, lets you pick the codec and audio track, and can import your Watch Later and History lists in one click.

Use only your own Bilibili account. OmniGet does not break DRM or paywalls: qualities that need a premium (大会员) subscription stay available only to accounts that have it.

## Where it is

-   Paste a Bilibili link in the box on **Home**; the Bilibili choices appear in **Download options**.
-   Sign-in and imports: **Settings › Downloads › Cookies**, on the Bilibili card.
-   Bilibili settings: **Settings › Downloads › Per-platform options** (click **Show advanced options**), under **Bilibili**.

## How to use it

### Sign in

The Bilibili card appears in **Settings › Downloads › Cookies** once OmniGet has cookies for bilibili.com, for example after you capture them with the [browser extension](https://getomniget.com/docs/extension).

-   **Sign in via Bilibili page** opens the Bilibili login page in a window.
-   **\+ Add another account** opens **Sign in to Bilibili with QR Code**. Open the Bilibili app on your phone and scan the code. The window shows **Scanned. Confirm sign-in on your phone.**, then **Signed in as …**. If the code expires, click **Generate new code**.

### Import Watch Later and History

When a Bilibili account is signed in, the card shows two buttons:

-   **Import Watch Later** adds every video in your Watch Later list to the [Queue](https://getomniget.com/docs/queue).
-   **Import History** adds the videos in your watch history.

OmniGet shows **Queued N items** when it is done.

### Pick quality, codec and audio

1.  Paste a Bilibili link on Home.
2.  OmniGet shows **Reading available qualities…**, then the kind of page (Video, Anime, Favorites, Collection, Watch Later…) and, for lists, how many items it has.
3.  Pick a **Quality**, a **Codec** (H.264 / AVC, H.265 / HEVC or AV1, shown when the chosen quality lists codecs) and an **Audio** track. **Auto** picks the best your account can get.
4.  Click the download button.

Your choices are kept for the next Bilibili downloads. Without a signed-in account, Bilibili offers lower qualities only; 4K, HDR, Hi-Res Lossless and Dolby need an account, and some of them need a premium subscription. OmniGet tells you when a quality on the page needs one.

## Options

In **Settings › Downloads › Per-platform options › Bilibili**:

| Option | What it does | Default |
| --- | --- | --- |
| **Output container** | MP4 works everywhere. MKV is recommended for Hi-Res FLAC or Dolby Atmos audio. | MP4 |
| **Download danmaku (弹幕)** | Saves the floating comments next to the video. Needs a signed-in Bilibili account. | Off |
| **Danmaku format** | XML (best player support), ASS (shows over the video in most players) or JSON (raw data). | XML |
| **Generate NFO metadata (Kodi / Jellyfin / Emby)** | Saves a `.nfo` file next to each download. Series get `tvshow.nfo` and `episode.nfo`. | Off |
| **Save cover image as sidecar file** | Saves the poster as its own image next to the video. | Off |
| **Cover format** | JPG (most compatible), PNG (lossless), WebP or AVIF (smaller). | JPG |
| **Filename templates** | One template per content type, such as **Single video**, **Multi-part video (分P)**, **Bangumi (anime / movie / series)** and **Channel / Favorites / Collection**. Click **Edit** to change them. | Title of the video for a single video |
| **CDN fallback** | **Alternative hosts (one per line, or comma-separated)** to try when the default CDN is slow or blocked in your region. | Empty |
| **Prefer alternative CDN over default** | Tries the alternative hosts first. | Off |

In filename templates, use variables such as `{title}` or `{bvid}`; the full list is shown under the fields. A `/` creates a subfolder. Click **Save changes** to keep text changes, or **Discard changes**.

## Common problems

### Only low qualities are listed

No Bilibili account is signed in, or the account does not have access to higher qualities. Sign in on the Bilibili card in **Settings › Downloads › Cookies**.

### Sign in to Bilibili first

**Import Watch Later** and **Import History** need a signed-in account. Sign in first.

### QR code expired. Generate a new one.

The code is valid for a short time. Click **Generate new code** and scan again.

### Not available in your region

Bilibili blocks the video where you are. If the CDN is the problem rather than the video, add hosts under **CDN fallback**.

[Previous**← Send a file with a code**](https://getomniget.com/docs/p2p) [Next**Sites and engines →**](https://getomniget.com/docs/sites)
