Toonily Manhwa Tracker
A comprehensive Tampermonkey userscript that automatically tracks your manhwa reading progress on Toonily.com. Keep track of what you've read, when you read it, and never lose your place again!
Features
🔄 Automatic Tracking
- Automatically detects and tracks manhwa from Toonily URLs
- Extracts manhwa names and chapter information seamlessly
- No manual input required - just browse normally
📊 Reading Progress
- Tracks which chapters you've read and when
- Records reading frequency and timestamps
- Shows total chapters read per manhwa
- Maintains complete reading history
🖼️ Visual Collection
- Automatically captures manhwa cover thumbnails
- Clean, organized display of your collection
- Visual progress indicators
💾 Persistent Storage
- Uses browser localStorage for permanent data storage
- Data persists across browser sessions
- No external servers or accounts required
🔍 Search & Filter
- Search through your tracked manhwa collection
- Filter by reading status or progress
- Quick access to specific titles
📱 User-Friendly Interface
- Floating tracker button for easy access
- Comprehensive popup interface
- Responsive design that works on all screen sizes
- Clean, modern UI
💼 Data Management
- Export your tracking data for backup
- Import data from other devices
- Clear individual manhwa or entire collection
Installation
Prerequisites
Steps
Install Tampermonkey
Install the Script
- Copy the script from
toonily-manhwa-tracker.user.js
- Open Tampermonkey dashboard
- Click "Create a new script"
- Paste the code and save (Ctrl+S)
Enable the Script
- Ensure the script is enabled in Tampermonkey
- Visit any Toonily manhwa page to start tracking
Usage
Basic Usage
Automatic Tracking: Simply visit any manhwa page on Toonily.com
- The script automatically detects and tracks the manhwa
- Chapter progress is recorded when you visit chapter pages
View Collection: Click the "📚 Tracker" button (top-right corner)
- See all your tracked manhwa
- View reading progress and statistics
- Access detailed chapter history
Interface Guide
Main Panel
- Search Bar: Find specific manhwa in your collection
- Manhwa Cards: Visual display with thumbnails and progress
- Chapter Count: Shows chapters read vs total available
- Last Read: Displays when you last read each manhwa
Chapter Details
- Click on any manhwa card to see detailed chapter history
- View reading dates and frequency
- See complete chapter progression
Data Management
- Export: Download your tracking data as JSON
- Import: Upload previously exported data
- Clear: Remove individual manhwa or entire collection
URL Pattern Recognition
The script automatically recognizes these URL patterns:
Manhwa Pages
```
https://toonily.com/serie/[manhwa-name]/
```
Example: https://toonily.com/serie/eleceed/
Chapter Pages
```
https://toonily.com/serie/[manhwa-name]/chapter-[number]/
```
Example: https://toonily.com/serie/eleceed/chapter-1/
Data Structure
The script stores data in the following format:
```javascript
{
"manhwa-name": {
"name": "Display Name",
"thumbnail": "image-url",
"chapters": {
"1": {
"readCount": 1,
"firstRead": "2024-01-01T12:00:00.000Z",
"lastRead": "2024-01-01T12:00:00.000Z"
}
},
"totalChapters": 10,
"lastVisited": "2024-01-01T12:00:00.000Z"
}
}
```
Browser Compatibility
- ✅ Chrome (Recommended)
- ✅ Firefox
- ✅ Edge
- ✅ Safari (with Tampermonkey)
- ✅ Opera
Privacy & Security
- Local Storage Only: All data is stored locally in your browser
- No External Requests: Script doesn't send data to external servers
- No Personal Information: Only tracks reading progress, no personal data
- Open Source: Full code is available for review
Troubleshooting
Script Not Working
- Ensure Tampermonkey is installed and enabled
- Check if the script is enabled in Tampermonkey dashboard
- Refresh the Toonily page
- Check browser console for errors
Data Not Saving
- Ensure localStorage is enabled in your browser
- Check if you're in incognito/private mode (data won't persist)
- Verify sufficient storage space
Tracker Button Not Visible
- Check if the script is running on the correct domain
- Disable other extensions that might interfere
- Try refreshing the page
Contributing
Contributions are welcome! Please feel free to:
- Report bugs
- Suggest new features
- Submit pull requests
- Improve documentation
License
This project is licensed under the MIT License - see the LICENSE file for details.
Author
sheikhlipu123
Changelog
v1.0.0
- Initial release
- Automatic manhwa and chapter tracking
- Persistent localStorage storage
- Visual collection interface
- Search and filter functionality
- Export/import capabilities
- Thumbnail extraction
Support
If you encounter any issues or have questions:
- Check the troubleshooting section above
- Open an issue on GitHub
- Provide browser version and error details for faster resolution
Enjoy tracking your manhwa reading progress!
