Need the French version? Read README_FR.md for the complete translation.
ed2k Manager is a lightweight userscript for Tampermonkey or Violentmonkey that scans any web page for ed2k:// links and presents them in a floating control panel. From there you can search, filter by size, select items, copy the exact list of links, or export the results for later use. The script runs entirely inside the browser, stores preferences locally, and keeps itself up to date.
- Instant detection of every ed2k link on the active page with a badge that shows the number of matches.
- Clean modal interface with bulk selection, regex search, and min/max size filters that accept human friendly values (
10MB,2GB, etc.). - Copy helpers for the checked links or for the whole list, plus CSV export (
name,size,link). - Automatic decoding of encoded filenames along with readable size displays (bytes are shown in the tooltip for accuracy).
- Context menu (right click the launcher button) to reposition or resize the button and reset preferences.
- Fully documented codebase in English so outside contributors can understand the logic quickly.
- A Chromium, Firefox, or Edge browser with Tampermonkey (recommended) or any compatible userscript manager installed.
- Internet access the first time you install the script so Tampermonkey can fetch
ed2k-manager.jsfrom GitHub.
- Install the Tampermonkey extension for your browser:
- Click Install ed2k Manager.
- Tampermonkey opens an install dialog; press Install.
- Reload any page that contains ed2k links. A small "ed2k" button appears in the lower right corner.
- Install Tampermonkey if you have not already done so.
- Open the Tampermonkey dashboard and click + / Add a new script.
- Copy the full contents of
ed2k-manager.js. - Paste the code into the Tampermonkey editor and save (Ctrl+S).
- Reload any target page; the "ed2k" launcher button becomes available.
Tampermonkey automatically checks GitHub for new releases, so you do not need to reinstall after future updates.
- Browse to a page that lists ed2k links and click the floating "ed2k" button.
- Review the list of detected links in the modal window. The badge reflects the total number of links.
- Type text or a regex such as
/S01E02/iin the search bar to narrow the list. Use Min/Max inputs to filter by size. - Select individual rows or click Select all. The footer shows how many items are selected.
- Choose Copy selection to send the selected links to the clipboard, Copy all for every link, or Export CSV to download
ed2k-links.csv. - Close the window by clicking Close, pressing Esc, or toggling the launcher button again.
The script is served directly from GitHub. Tampermonkey checks the canonical URL on a schedule and replaces the local copy whenever a new version is published. As long as the userscript is enabled, you will silently receive the latest UI tweaks and bug fixes.
- Button does not show: Confirm the script is enabled in Tampermonkey and reload the page. Some sites require a hard refresh (Ctrl+F5).
- Clipboard copy fails: Refresh the tab; a few browsers restrict clipboard access until the page gains focus after installing a script.
- Layout issues on very long lists: Keep an eye on the TODO list where UI refactors and performance work are tracked.
All planned phases are tracked in TODO.md, from the UI overhaul to history tabs, duplicate detection, statistics, and more. Feel free to open an issue to discuss ideas or report bugs, and every suggestion helps shape the next milestone.
Pull requests are welcome for bug fixes, enhancements, documentation, or translation improvements. The code comments and docstrings are written in English. If you add UI strings, please keep them easy to translate, and include screenshots or short clips when proposing interface changes.
Happy collecting, and thank you for helping the ed2k ecosystem stay organized!