WARNING: This project is ABANDONED and UNTESTED. Many features were implemented but never fully tested in a live environment. Use at your own risk!
A userscript designed for 1337x uploaders to manage comments, quick replies, requests, and user interactions. Built to help uploaders efficiently handle the flood of comments on their uploads.
No screenshots available. Due to the account ban, proper documentation including screenshots could not be captured before release. If you use this script and would like to contribute screenshots, feel free to submit a pull request!
The original developer (MankeyDoodle) was banned from 1337x before this script could be properly released and tested. This script is being uploaded to preserve all the work done by MankeyDoodle and UncleSamurott, despite the ban.
- Many recently implemented features have NOT been tested in a live environment
- The script requires uploader account verification on 1337x to function properly, which is no longer possible due to the ban
- This script was primarily tested on Google Chrome - browser-specific bugs on Firefox, Safari, Edge, etc. were NOT tested
- This was the developer's first attempt at creating a public userscript
- Some features may be buggy or incomplete
- No official support will be provided by the original author
- The code is provided AS-IS
This project is now open for the community to:
- Fork and continue development
- Use for personal projects
- Learn from the codebase
- Submit pull requests (though review may be delayed or not happen)
- Make it your own!
This script is an INDEPENDENT, OPEN-SOURCE project.
It is NOT affiliated with, endorsed by, or related to 1337x in any way. The authors (MankeyDoodle and UncleSamurott) have NO connection to 1337x staff or administration.
- Block Users - Hard block (hides comments completely) or soft block (highlights only)
- Trust Users - Green highlight for friends, helpers, and trusted commenters
- Temporary Blocks - Set expiry dates for blocks
- Custom Notes/Reasons - Add tags and notes to blocked/trusted users
- Keyword Filtering - Auto-hide comments containing specific keywords
- Highlighted Keywords - Mark important comments containing specific terms
- Template System - Pre-defined quick reply templates for different user types
- Categories - Blocked, Trusted, Neutral, and Seeding/Speed question templates
- Customizable - Add your own custom reply templates
- Universal Picker - Access all templates from any user type
- Inline Tags - Display custom tags next to usernames in comments
- Multiple Tags - Support for multiple tags per user
- Tag Filtering - Filter your lists by tags
- Custom Tag Colors - Define colors for your custom tags
- Import/Export - Backup and share your lists
- Track Requests - Keep track of user requests from comments
- Status Management - Pending, Completed, Declined statuses
- Sub-tasks - Break down requests into smaller tasks
- Save Comments - Save important comments as notes
- Tag Notes - Organize notes with tags
- Search & Filter - Find notes by username, text, or tags
- Archive - Keep completed notes for reference
- 8 Built-in Themes - Classic, 1337x, Midnight, Ocean, Colorblind, Monkey, Typewriter, Candy
- Full Customization - Panel colors, fonts, badge colors
- Badge Contrast - Auto/manual contrast settings for readability
- VIP/Moderator Detection - Auto-badges for site VIPs and Mods
- Notifications Search - Search through your notifications
- Uploads Search - Search through your uploads
- Keyboard Shortcuts - Quick actions with keyboard
- Statistics - Track how many comments you've hidden
Choose one based on your browser:
| Browser | Recommended Manager |
|---|---|
| Chrome, Edge, Brave, Opera | Tampermonkey or Violentmonkey |
| Firefox | Tampermonkey or Violentmonkey |
| Safari | Userscripts |
Option A: From GreasyFork (Recommended)
- Visit the GreasyFork page
- Click "Install this script"
Option B: Manual Installation
- Click on your userscript manager icon
- Select "Create a new script"
- Delete any default code
- Copy and paste the contents of
dist/mankey-bot-1337x-comment-assistant.user.js - Save the script (Ctrl+S / Cmd+S)
- Visit any 1337x page
- The script activates automatically
- Look for the MaNKeY-Bot panel button
- Bun (JavaScript runtime and package manager)
# Install dependencies
bun install
# Build the userscript
bun run buildsrc/
├── main.js # Main entry point
├── constants.ts # Global constants
├── styles/ # CSS styles
├── themes/ # Theme definitions
├── storage/ # Persistent storage functions
├── utils/ # Utility functions
├── ui/ # UI components
│ └── panel/ # Management panel
└── types/ # TypeScript definitions
The following features were implemented shortly before the ban and were never properly tested:
- Search box injected into user's notifications page
- "Load All" button fetches all notification pages (up to 50 pages)
- Client-side instant filtering by username
- Shows blocked/trusted badges next to usernames
- Results cached in GM storage with 1-hour expiry
- Search box injected into user's uploads page
- "Load All" button fetches all pages of uploads (up to 100 pages / ~2000 uploads)
- Client-side instant filtering by torrent title
- Background fetch of comment counts per upload
- Results cached in GM storage with 1-hour expiry
- New keyword type that highlights comments instead of hiding them
- Keyword tab now has sub-tabs: "Blocked" (hide) and "Highlighted" (mark visually)
- Highlighted keywords show a cyan border and notice with the matched keyword
- Bulk actions to move keywords between blocked/highlighted
- Works on trusted users too
- VIPs and Moderators are now auto-whitelisted
- Visual MOD/VIP badges next to site-trusted usernames
- Context menu shows limited options for VIPs/Mods
- Keyboard shortcuts skip site-trusted users
- "Move to Trust" button in block tab
- "Move to Block" button in trust tab
- "Whitelist" button in trust tab
- CSV Import/Export for Notes, Requests, Trust list, Block list
- Theme-specific styling (especially light themes like Typewriter, Candy)
- Typewriter and Candy themes in general
- Welcome screen theme selection
If you encounter bugs, feel free to open an issue or submit a fix!
These features were planned but never built due to the ban:
- Custom request limit per user (including "unlimited" option)
- Total active requests limit setting
- Sub-task counting option (count each sub-task as separate request)
- Notes toggle in welcome screen (on/off)
- Nested sub-tasks (up to 3 layers deep)
- Remember last tab (open on previously viewed tab)
- Archive tab for Requests page
- Recently Deleted tab (14-day recovery for Notes and Requests)
- Import/Export custom themes
- User-created theme importing
- Make Monkey theme the default
- MankeyDoodle (MNKYDDL) - Creator & Lead Developer
- UncleSamurott - Co-Developer
- Phosphor Icons - MIT License
This project is released under the MIT License. Feel free to use, modify, and distribute as you see fit.
MIT License
Copyright (c) 2025 MankeyDoodle
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
This script was a passion project created to help the 1337x uploader community. While I (MankeyDoodle) can no longer use or maintain it, I hope someone finds it useful or can continue its development.
If you fork this project, feel free to:
- Remove my credits if you make significant changes
- Rename it to something else
- Take it in a completely different direction
Good luck, and happy uploading!
Originally made with love for the 1337x community