Nyaa Enhancer

A comprehensive browser extension that enhances Nyaa torrent sites with advanced batch operations, intelligent filtering, user monitoring, and seamless integration features for power users.

Table of Contents

1. About The Project
   • Built With
   • Features
2. Getting Started
   • Installation
   • Usage
3. License

About The Project

Nyaa Enhancer is a powerful browser extension that transforms your Nyaa torrent browsing experience. Beyond basic batch operations, it offers intelligent filtering, user monitoring, seamless Animetosho integration, and comprehensive customization options. Whether you're a casual user looking to copy a few magnet links or a power user managing large collections, Nyaa Enhancer provides the tools you need for efficient torrent management.

(back to top)

Built With

• Chrome Extensions API - Core extension functionality
• JSZip - ZIP file creation for batch downloads

(back to top)

Features

Core Functionality:

• Adds checkboxes next to each torrent entry for easy selection
• "Copy Selected" button to copy checked magnet links
• "Copy All" button to copy all magnet links on the page
• "Download Selected" button to download checked torrent files
• "Download All" button to download all torrent files on the page
• "Invert Selection" button to toggle all checkbox states
• "Clear Selection" button to uncheck all boxes
• Selection counter showing number of selected items
• Shift+click support for range selection of torrents
• Individual magnet copy buttons for each torrent
• Toast notifications with progress tracking

Enhanced Navigation:

• Animetosho (AT) links for anime torrents with direct integration
• Quick Search functionality for fast torrent filtering
• Keyword-based torrent selection and filtering
• File size filtering with customizable ranges
• Dead torrent hiding capability
• Comment hiding on torrent view pages

Advanced Features:

• User monitoring system to track favorite uploaders
• Keyword filtering with custom word lists
• File size range filtering (256MB, 512MB, 1GB, 2GB, 4GB options)
• Customizable file options:
  • Use anime titles as torrent filenames
  • Combine downloads into ZIP files
• Settings sync across browser sessions and devices
• Comprehensive notification system with toggle options
• Changelog navigation with dismissible updates

Supported Domains:

• Supports multiple Nyaa mirror domains for maximum accessibility

(back to top)

Getting Started

To install the extension in your browser, follow these steps.

Installation

Chrome Web Store (up-to-date at 1.9.1):

Firefox Add-Ons Store (up-to-date at 1.9.1):

Edge Add-Ons Store (up-to-date at 1.9.1):

Download extension files locally (always up-to-date):

Chrome/Any chromium based browser (Edge, Brave etc.):

1. Download the zipped files of the repo or clone the repository
2. Open Chrome/Edge and navigate to chrome://extensions/
3. Enable "Developer mode"
4. Click "Load unpacked" and select the src/chrome directory

Firefox:

1. Download the zipped files of the repo or clone the repository
2. Open Firefox and navigate to about:debugging#/runtime/this-firefox
3. Click "Load Temporary Add-on"
4. Navigate to the src/firefox directory and select any file

Usage

Basic Operations:

1. Visit any supported Nyaa torrent site
2. Use the checkboxes to select desired torrents (Shift+click for range selection)
3. Click "Copy Selected" to copy selected magnet links
4. Click "Copy All" to copy all magnet links on the page
5. Click "Download Selected" to download selected torrent files
6. Click "Download All" to download all torrent files on the page
7. Use "Invert Selection" to toggle all checkbox states
8. Use "Clear Selection" to uncheck all boxes
9. Use individual magnet buttons for quick single-torrent copying

Advanced Features:

• Quick Search: Use the Quick Search button for fast torrent filtering
• Keyword Select: Automatically select torrents based on predefined keywords
• AT Links: Click Animetosho links for anime torrents to access additional resources
• User Monitoring: Track favorite uploaders and get notifications for new uploads
• File Size Filtering: Filter torrents by size ranges (256MB to 4GB+)

Extension Settings (accessible via popup menu):

General Settings:

• Show Buttons: Toggle main extension functionality on/off
• Show AT Links: Display Animetosho integration links for anime
• Show Magnet Buttons: Display individual magnet copy buttons
• Show Quick Filter: Enable/disable Quick Search functionality
• Show Changelog Navigation: Toggle update notification visibility

Download Options:

• Use Display Name as Filename: Uses anime titles instead of torrent IDs
• Combine Downloads as ZIP: Packages multiple torrents into a single ZIP file

Filtering Options:

• Hide Dead Torrents: Automatically hide torrents with 0 seeders
• Keyword Filtering: Enable automatic filtering based on custom keywords
• File Size Filtering: Filter torrents by customizable size ranges
• Show Filter Notifications: Toggle filtering notification messages
• Hide Comments: Hide comment sections on torrent view pages

Monitoring:

• Monitor Users: Track specific uploaders for new content
• Keyword Management: Add/remove keywords for automatic selection

Supported Domains:

• nyaa.si
• nya.iss.one
• nyaa.ink
• nyaa.land
• nyaa.digital
• ny.iss.one

Look for the green "On" badge in your browser toolbar to confirm the extension is active for the current site.

(back to top)

License

Distributed under the GPLv3 License. See LICENSE.txt for more information.

(back to top)