A modern, feature-rich desktop application for managing and organizing your bookmarks with an intuitive interface.

中文版本 | User Guide | 用户指南

• 📁 Hierarchical Organization: Organize bookmarks in folders and subfolders
• 🔍 Powerful Search: Quick search across all bookmarks with filters
• 🌐 Favicon Support: Automatic favicon fetching and caching
• 📥 Import/Export: Support for Chrome, Firefox, HTML, and JSON formats
• 🎲 Blind Box: Random bookmark discovery feature
• 📚 History Tracking: Keep track of accessed bookmarks
• 🔒 Edit Lock Mode: Prevent accidental modifications
• 🌍 Multi-language: Support for Chinese, English, Japanese, German, French, Korean, and Spanish
• 💾 Auto-backup: Automatic data backup and restore

• Python 3.7 or higher
• Windows（not test in macOS or Linux)

1. Clone the repository

   git clone https://github.com/yourusername/url-navigator.git
   cd url-navigator

2. Install dependencies

   pip install -r requirements.txt
   

3. Run the application

   python main.py
   

   Alternative: Download Pre-built Executable

   Download the latest release from the Releases page.

1. Adding Bookmarks : Click the "Add" button or drag URLs from your browser
2. Creating Folders : Right-click in the sidebar to create new folders
3. Searching : Use Ctrl+F or click the search icon
4. Import/Export : Access through the File menu For detailed instructions, see the User Guide .

url-navigator/
├── main.py              # Application entry point
├── app.py               # Main application class
├── config.py            # Configuration management
├── requirements.txt     # Python dependencies
├── ui/                  # User interface modules
│   ├── main_window.py   # Main window
│   ├── dialogs.py       # Dialog windows
│   └── ...
├── models/              # Data models
│   ├── data_manager.py  # Data persistence
│   └── ...
├── services/            # Business logic services
│   ├── favicon_service.py
│   ├── import_export.py
│   └── ...
├── utils/               # Utility modules
├── resources/           # Static resources
├── languages/           # Internationalization files
└── docs/                # Documentation

1. Install development dependencies

   pip install pyinstaller
   

URL Navigator单EXE体验版

The application supports multiple languages. Language files are located in the languages/ directory:

• zh.json - Chinese (Simplified)

• en.json - English

• ja.json - Japanese

• de.json - German

• fr.json - French

• ko.json - Korean

• es.json - Spanish

  🤝 Contributing

  We welcome contributions! Please see our Contributing Guidelines for details.

1. Fork the repository

2. Create a feature branch ( git checkout -b feature/amazing-feature )

3. Commit your changes ( git commit -m 'Add amazing feature' )

4. Push to the branch ( git push origin feature/amazing-feature )

5. Open a Pull Request

   📝 License

   This project is licensed under a Custom License - see the LICENSE file for details.

Please use the GitHub Issues page to report bugs or request features.

• 📖 User Guide

• 🐛 Issue Tracker

• 💬 Discussions

  🙏 Acknowledgments

• Built with PyQt5

• Icons from various open source icon sets

• Thanks to all contributors and users ⭐ If you find this project useful, please consider giving it a star!