Skip to content

A modern, high-performance desktop downloader for Pixiv, Twitter, Rule34, and 200+ other sites. Built with Electron, React, and Python, featuring batch downloading and a sleek dark-themed UI.

License

Notifications You must be signed in to change notification settings

noxium-dev/NekoBox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NekoBox Icon

NekoBox

Modern Bulk Image Downloader for Image Boards & Galleries

Platform License Electron React TypeScript


A high-performance desktop application for bulk downloading images and galleries from popular image boards and art platforms. Built with Electron, React, TypeScript, and Python.

⭐ Star this repository

FeaturesScreenshotsSupported SitesInstallationQuick StartLicense


📸 Screenshots

Main Interface

NekoBox Interface

Settings - Gallery-dl Extension Installation

Settings Panel Click the "Install Gallery-dl Extension" button to easily install gallery-dl support


📋 View Detailed Features

⚡ High-Speed Downloads

  • 5-50 concurrent downloads
  • Individual file progress tracking
  • Real-time speed monitoring (MB/s)
  • Smart bandwidth management

🎯 Intelligent Download Modes

  • Single Mode: Direct image/post URLs
  • Batch Mode: Entire galleries & profiles
  • Configurable download limits
  • Automatic retry on failure

🎨 Modern Interface

  • Dark-themed UI with Chakra UI
  • Real-time progress visualization
  • Expandable download cards
  • Clean, responsive design

⚙️ Flexible Configuration

  • Custom download directories
  • Quality settings (Original/High/Medium)
  • File type filtering (Image/Video)
  • Advanced naming patterns
  • Connection settings

🔐 Authentication Support

  • Cookie-based authentication
  • Browser cookie import
  • Session management
  • Multi-account support

📊 Download Management

  • Pause/Resume functionality
  • Queue prioritization
  • Duplicate detection
  • Automatic folder organization

🌐 Supported Sites

🚀 Native High-Performance Scrapers

Built-in, optimized scrapers for:

  • Pixiv (User galleries, bookmarks, rankings, tags)
  • Rule34 (Tag search, pools, posts)

🔌 Extensible Support (210+ Sites)

Integration with gallery-dl enables support for thousands of additional sites including Reddit, DeviantArt, Danbooru, Gelbooru, and many more.

⚠️ Note: Some sites may not work due to authentication restrictions or API changes. We are actively working to bring you more options and improve compatibility.

📋 See the full Supported Sites List for details.


📥 Installation

Platform: Windows only (x64)

Download the App

  1. Download the latest release from the Releases page
  2. Run the installer (NekoBox Setup.exe)
  3. Launch the application

Install Gallery-dl (Optional but Recommended)

Gallery-dl is an optional external extension that provides support for 210+ sites.

Quick Install:

Option 1: Using NekoBox (Recommended)

  1. Open NekoBox
  2. Navigate to Settings
  3. Click Install Gallery-dl Extension button
  4. Wait for installation to complete

Option 2: Manual Installation

pip install gallery-dl

📚 See GALLERY-DL-SETUP.md for detailed installation instructions.

Why is Gallery-dl Optional?

Gallery-dl is licensed under GPL-2.0+ (GNU General Public License). To maintain licensing flexibility and comply with GPL requirements, gallery-dl is kept as an optional external dependency that users install separately.

Benefits:

  • ✅ Clear license boundaries
  • ✅ Users choose whether to install it
  • ✅ Always get the latest gallery-dl version
  • ✅ Respects GPL-2.0+ licensing requirements

🚀 Getting Started

Quick Start

Ready to start downloading? Check out our Quick Start Guide for:

  • 📁 Setting up download folders
  • 🎯 Using Single & Batch modes
  • 🔐 Configuring authentication
  • 🛠️ Troubleshooting common issues

🛠️ Technologies

Frontend Backend Tools
Electron Python Gallery-dl
Desktop Framework Scraping Engine External Engine
React C++
UI Framework Download Engine
TypeScript
Type Safety
Chakra UI
Components
Zustand
State Management

🚧 Roadmap

We are constantly working to improve NekoBox and bring you more features:

  • 🌍 Multi-language support
  • 🔔 Download completion notifications
  • 📊 Advanced filtering and sorting
  • 🎨 Custom theme support
  • 🔄 Auto-update functionality
  • 📱 Mobile companion app (future)

Stay tuned for updates! ⭐ Star this repo to follow our progress.


⚠️ Important Notes

Authentication Requirements

  • Pixiv requires login (cookie export)
  • Some gallery-dl sites may require authentication
  • Export cookies using browser extensions (e.g., "Get cookies.txt")
  • Import cookies via Settings → Authentication

Site Compatibility

  • Some sites may experience temporary issues due to:
    • API changes or updates
    • Anti-bot measures
    • Rate limiting
    • Regional restrictions
  • We actively monitor and update scrapers

Performance Tips

  • Concurrent downloads: Start with 10-20, adjust based on your connection
  • Authentication: Pre-configure cookies for faster access
  • Disk space: Ensure adequate space for batch downloads

📄 License

Copyright © 2026. All Rights Reserved.

This project is for demonstration and portfolio purposes only. See the LICENSE file for full terms.

Note: This application uses gallery-dl as an optional external dependency. Gallery-dl is licensed under GPL-2.0+ and is not bundled with this application.


🙏 Credits

  • Gallery-dl: mikf/gallery-dl - GPL-2.0+
  • Built with ❤️ using Electron, React, and TypeScript

💬 Support & Contributing

Get Help

Show Your Support

If you find NekoBox useful, please:

  • Star this repository
  • 🐛 Report bugs and issues
  • 💡 Suggest new features
  • 📢 Share with others

⚠️ Disclaimer

This tool is for personal use only. Please respect the terms of service of the websites you download from and respect copyright laws.


Made with ❤️ for the community

⭐ Star on GitHub

About

A modern, high-performance desktop downloader for Pixiv, Twitter, Rule34, and 200+ other sites. Built with Electron, React, and Python, featuring batch downloading and a sleek dark-themed UI.

Topics

Resources

License

Stars

Watchers

Forks