A robust, Python-based credential checker tool with concurrent processing, proxy support, and a user-friendly web interface.
- Batch Credential Processing: Process multiple text files containing credentials in
domain:username:passwordformat - Concurrent Processing: Multi-threaded credential checking with configurable worker threads
- Proxy Support: Rotate through proxies with automatic validation
- Web Interface: Flask-based UI for easy file uploads and result viewing
- CLI Interface: Command-line interface for automation and scripting
- Smart Login Detection: Attempts multiple common login endpoints and field names
- Organized Results: Results saved by domain in separate folders
- Error Handling: Graceful handling of network errors and invalid credentials
- Detailed Logging: Comprehensive logging for debugging and monitoring
- Python 3.9 or higher
- pip (Python package manager)
- Clone or download this repository
- Install dependencies:
pip install -r requirements.txt- Start the Flask web server:
python app.py- Open your browser and navigate to
http://localhost:5000 - Upload your credential files (search_*.txt format)
- Optionally upload a proxy.txt file
- Set the number of worker threads
- Click "Start Processing" and view results in real-time
Basic usage:
python juba_checker.py --folder /path/to/credentialsWith all options:
python juba_checker.py --folder /path/to/credentials --output ./results --workers 20 --proxy-file proxy.txtDry run (preview without checking):
python juba_checker.py --folder /path/to/credentials --dry-run--folder: (Required) Folder containing search_*.txt files--output: Output directory for results (default:results)--workers: Number of concurrent worker threads (default: 10)--proxy-file: Path to proxy.txt file for proxy rotation--dry-run: Preview what would be checked without performing login attempts
Each line should follow this format:
example.com:user@email.com:password123
domain.com:username:pass:word:with:colons
site.org:admin:secretpass
One proxy per line in standard format:
http://proxy1.com:8080
http://user:pass@proxy2.com:3128
socks5://proxy3.com:1080
Results are organized by domain:
results/
├── example.com/
│ └── results.txt
├── domain.com/
│ └── results.txt
└── site.org/
└── results.txt
Each results.txt contains successful credentials in the same format as input.
To create a standalone Windows executable:
pyinstaller juba_checker.specThe executable will be created in the dist/ folder.
/- Home page with upload form/upload- Handle file uploads and start processing/results/<job_id>- View results for a specific job/status/<job_id>- Get JSON status of a job/download/<filepath>- Download results file/jobs- List all processing jobs
- This tool is for authorized security testing only
- Always obtain proper authorization before testing credentials
- Use responsibly and ethically
- Keep proxy credentials secure
- Results files contain sensitive information - protect them appropriately
Logs are written to:
- Console output (real-time)
juba_checker.logfile (persistent)
Log levels:
- INFO: Successful logins and processing status
- DEBUG: Detailed request information
- ERROR: Failed operations and exceptions
- Verify credential format is correct
- Check that domains are accessible
- Try reducing worker count to avoid rate limiting
- Enable DEBUG logging for more details
- Ensure proxies are in correct format
- Test proxies manually before use
- Some proxies may require authentication
- Check firewall settings
- Ensure port 5000 is not in use
- Try accessing via
http://127.0.0.1:5000
- Start with 10 workers and adjust based on your system
- Use proxies to avoid IP-based rate limiting
- Process smaller batches for faster feedback
- Monitor system resources during processing
This tool is provided as-is for educational and authorized security testing purposes only.
The authors are not responsible for misuse of this tool. Always ensure you have proper authorization before testing any credentials or systems.
For issues, questions, or contributions, please refer to the project documentation or contact the development team.