iqDL

iqDL is a Chrome Manifest V3 extension that adds SRT download buttons for subtitle tracks exposed by the iQIYI web player on iq.com and iqiyi.com.

The extension only downloads subtitle URLs already visible to the browser/player. It does not bypass DRM, unlock unavailable tracks, or bulk download whole shows.

Install Locally

1. Open chrome://extensions.
2. Enable Developer mode.
3. Click Load unpacked.
4. Select this repository folder.
5. Open or refresh an iQIYI video page.

Use

1. Start playback on an iq.com/play/... or iqiyi.com video page.
2. Open the player subtitle settings.
3. Click the SRT button next to a language.
4. Chrome downloads that subtitle as an .srt file.

If the extension detects subtitle tracks but cannot safely match iQIYI's current settings menu markup, it shows a small fallback subtitle panel near the player with the same SRT buttons.

Troubleshooting

• Refresh the video page after installing or updating the extension.
• Start playback before opening subtitle settings so the player loads metadata.
• Open subtitle settings once if buttons do not appear immediately.
• Check that Chrome has not blocked download permission for the extension.
• Some videos expose no subtitle URLs to the browser until an account, region, or playback state allows them.

Development

Run the helper tests:

npm test

Key files:

• src/page-hook.js runs in the page context and observes player metadata responses.
• src/content.js injects download buttons into the iQIYI UI.
• src/background.js fetches subtitle URLs, converts the content to SRT, and starts Chrome downloads.
• src/srt.js contains pure subtitle conversion and filename helpers.

Releases

Every push to master publishes a GitHub release with a packaged extension zip. Release tags and packaged extension version_name values use YYYY.MM.DD.X, where X increments when multiple releases are published on the same Europe/Berlin calendar day. The packaged manifest.version uses Chrome's required non-padded numeric form of the same value.