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. Detection is robust (including percent-encoded ed2k links), and tome extraction is now much more capable: it recognizes explicit markers (T01, Tome 39, HS2), implicit layouts (- 01 -, .02., 02 (sur 3)), and special editions like integrales and packs. 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.
- Robust detection of ed2k links on the active page, including percent-encoded links such as
ed2k://%7Cfile%7C..., with a badge that shows the number of matches. - Advanced tome extraction with a dedicated column and a default sort that brings the highest tome to the top while keeping unknown tomes at the end.
- Tome extraction handles explicit markers, implicit numbering patterns, and special editions like integrales (
INT) and range packs (PACK). - Click on a file name to toggle its checkbox and copy its ed2k link immediately.
- Clean modal interface with bulk selection, Shift+click range selection, regex search, and min/max size filters that accept human friendly values (
10MB,2GB, etc.). - A live selection counter in the header so you always see how many links are checked.
- Copy helpers for the checked links or for the whole list, plus exports to CSV (
name,size,link) and.emulecollection(exports use the selection when it exists, otherwise the full list). - 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 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, the header shows how many are selected, and the Tome column is used by default for sorting.
- 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, use Shift+click to select a range, or click Select all. You can also click directly on a file name to toggle selection and copy that single link.
- Choose Copy selection to send the selected links to the clipboard, Copy all for every link, Export CSV to download
ed2k-links.csv, or Export .emulecollection. Both exports use the selection when it exists, otherwise they export the full list. - 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: See the TODO-LIST section at the end of this README for planned performance and UI improvements.
The roadmap is summarized in the TODO-LIST section at the end of this README. 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!