Getting‐Started - Futs/kuroibara GitHub Wiki
🚀 Getting Started with Kuroibara
Welcome to Kuroibara! This guide will help you get up and running with your new manga management platform.
📋 Prerequisites
Before you begin, make sure you have:
- ✅ Kuroibara installed and running (Installation Guide)
- ✅ Access to the web interface (usually
http://localhost:3000
) - ✅ A user account created
🎯 Step 1: Create Your Account
- Navigate to Kuroibara in your web browser
- Click "Register" to create a new account
- Fill in your details:
- Username (3-50 characters)
- Email address
- Strong password (8+ characters)
- Verify your email (if email verification is enabled)
- Log in with your new credentials
🔐 Optional: Enable Two-Factor Authentication
For enhanced security, consider enabling 2FA in your profile settings.
🎨 Step 2: Customize Your Experience
Set Your Preferences
- Go to Settings (gear icon in the top navigation)
- Choose your theme: Light, Dark, or System
- Configure NSFW settings: Enable blur for adult content if desired
- Set download preferences: Quality, path, and file formats
Configure Providers
- Navigate to Settings → Provider Preferences
- Review available providers (100+ manga sources)
- Enable/disable providers based on your preferences
- Set favorites for faster search results
- Reorder providers by priority
🔍 Step 3: Your First Search
Search for Manga
- Click the Search tab in the main navigation
- Enter a manga title (e.g., "One Piece", "Naruto")
- Select providers or leave as "All" for comprehensive results
- Browse the results with cover images and descriptions
Understanding Search Results
- Provider badges show the source of each result
- Status badges indicate if manga is ongoing, completed, etc.
- Cover images provide visual identification
- Descriptions give you a preview of the story
📚 Step 4: Build Your Library
Add Manga to Your Library
- Find a manga you want to read
- Click the "+" button on the search result card
- Choose a category (optional)
- The manga is now in your library!
Organize Your Collection
- Visit the Library tab to see your collection
- Create categories (e.g., "Currently Reading", "Plan to Read")
- Create reading lists for specific themes or recommendations
- Rate and review manga you've read
📖 Step 5: Start Reading
Access Manga Details
- Click on any manga in your library or search results
- View detailed information: description, genres, authors, status
- See available chapters from different providers
- Check reading progress and bookmarks
Reading Experience
- Click on a chapter to start reading
- Use navigation controls: next/previous page, chapter navigation
- Bookmark your progress automatically
- Switch between providers if chapters are unavailable
📋 Step 6: Manage Reading Lists
Create Reading Lists
- Go to Reading Lists in the main navigation
- Click "Add Reading List"
- Give it a name (e.g., "Favorites", "Recommendations")
- Add manga from your library or search results
Organize with Categories
- Visit Categories to create custom organization
- Create categories like "Action", "Romance", "Completed"
- Assign manga to multiple categories
- Filter your library by category
🔧 Step 7: Advanced Features
Download for Offline Reading
- Enable downloads in settings
- Choose download quality and storage location
- Queue chapters for background downloading
- Access offline when internet is unavailable
External Account Integration
- Link AniList account for sync and recommendations
- Connect MyAnimeList for cross-platform tracking
- Import existing lists from external services
Profile Customization
- Upload an avatar in profile settings
- Write a bio to personalize your profile
- Set reading preferences and display options
🎯 Quick Tips for New Users
🔍 Search Tips
- Use specific titles for better results
- Try alternative spellings or romanizations
- Use the provider filter to find specific sources
📚 Library Management
- Create categories before adding lots of manga
- Use reading lists for temporary collections
- Rate manga to get better recommendations
⚙️ Provider Management
- Disable slow or unreliable providers
- Favorite your most trusted sources
- Check provider status in settings
🚀 Performance Tips
- Limit concurrent downloads
- Clear cache periodically
- Use favorites to reduce search time
🆘 Need Help?
If you run into any issues:
- Check Common Issues for quick solutions
- Visit Troubleshooting for detailed guides
- Search the Wiki for specific topics
- Ask in Discussions for community help
- Report bugs in the Issue Tracker
🎉 You're Ready!
Congratulations! You now have everything you need to start enjoying Kuroibara. Happy reading! 📖
Next Steps
- 📱 User Guide - Detailed feature documentation
- 🌐 Supported Providers - Explore all available sources
- 💡 Tips & Tricks - Community best practices
🧭 Navigation
🏠 Home: Wiki Home → Next: User Guide 🔧 Installation: Installation Guide
Need more help? Visit our Help & Support page.