Text Extractor

---

Welcome to Advanced Tab Manager Pro, a sophisticated Python-based desktop application built with PyQt6 and Selenium, designed to automate browser tab management with extensive customization options. This tool is ideal for developers, testers, and automation enthusiasts needing to efficiently manage multiple Chrome tabs across multiple instances, with features like headless mode, proxy support, multilingual interface, and real-time system monitoring.

Table of Contents

• Features
• Supported Browsers
• Installation
• Usage
  • Getting Started
  • Main Tab
  • Advanced Tab
  • Settings Tab
  • System Tab
  • Logs Tab
  • About Tab
• Screenshots
• Releases
• Support
• Contributing
• Security
• License
• Dependencies

Features

• Multi-Instance Tab Management: Run multiple Google Chrome instances simultaneously, each managing its own set of tabs.
• Customizable Browser Options: Support for headless mode, incognito, proxy settings, custom user agents, and additional Chrome arguments.
• Multilingual Interface: Supports English, Japanese, Korean, Chinese, and Filipino with dynamic language switching.
• Themeable Interface: Choose from six visually appealing themes (Dark Navy, Light Blue, Dark Green, Light Green, Soft Pink, Soft Lavender).
• Real-Time System Monitoring: Track CPU, memory, and disk usage with live updates using psutil.
• Detailed Logging: Color-coded logs with filtering (INFO, WARNING, ERROR) and export capabilities.
• Advanced Configuration: Fine-tune browser behavior with proxy settings, user agent customization, and Chrome command-line arguments.
• Automatic Updates: Check for new versions on startup with optional notifications using requests.
• Cross-Platform GUI: Built with PyQt6 for a modern, intuitive interface compatible with Windows, macOS, and Linux.
• Process Management: Robust handling of Chrome and ChromeDriver processes to prevent resource leaks.
• Error Handling: Comprehensive error detection and logging for reliable operation.

Supported Browsers

Advanced Tab Manager Pro currently supports:

• Google Chrome: Managed via Selenium WebDriver with automatic ChromeDriver installation using webdriver-manager.

Note: Support for additional browsers (e.g., Firefox, Edge) is planned for future releases.

Installation

Advanced Tab Manager Pro is packaged as a Python application, making it easy to run or distribute across platforms. You can either build from source or use pre-compiled binaries where available.

Building from Source (All Platforms)

1. Ensure you have Python 3.8+ installed on your system (Windows, macOS, Linux).

2. Clone this repository:

   git clone https://github.com/VoxDroid/Advanced-Tab-Manager.git
   cd Advanced-Tab-Manager

3. Install dependencies:

   pip install -r requirements.txt

   If requirements.txt is not present, manually install:

   pip install PyQt6 selenium psutil qtawesome webdriver-manager requests packaging

4. Run the application:

   python app.py

   This will launch the GUI using app.py and automatically install the appropriate ChromeDriver version via webdriver-manager.

Pre-Compiled Binaries

• Windows: Download the latest .exe (portable) or .msi (installer) tagged with [W] for Windows, from the Releases page. Run the MSI installer or use the portable version for no-setup runs.
• macOS: Download the latest universal .dmg (x86_64 and Apple Silicon) tagged with [M] for macOS, from the Releases page. Open the DMG, drag the app to Applications, and launch it.
• Linux: Download the latest .rpm (for Fedora/Red Hat), .deb (for Debian/Ubuntu), or .pkg.tar.zst (for Arch/Pacman) tagged with [L] for Linux, from the Releases page. Run the installer and launch the app.

Note: Pre-compiled binaries require Google Chrome to be installed on the system.

Usage

Upon launching Advanced Tab Manager Pro, you’ll see the main interface featuring six tabs: Main, Advanced, Settings, System, Logs, and About. The in-app About Tab contains additional usage information.

Getting Started

• Launch the application using python [app.py](https://github.com/VoxDroid/Advanced-Tab-Manager/blob/main/src/advancedtabmanager/app.py) or a pre-compiled binary.
• Explore the Main Tab to configure and start tab management tasks.
• Customize browser options in the Advanced Tab and application settings in the Settings Tab.
• Monitor system resources in the System Tab and view detailed logs in the Logs Tab.
• Refer to the About Tab for application details and licensing information.

Main Tab

• Purpose: Configure and control tab management tasks.
• How to Use:
  1. Enter a valid URL (e.g., https://google.com) in the URL field.
  2. Set the number of iterations (0 for infinite) and interval (seconds) between tab openings.
  3. Specify the number of browser instances (1–10).
  4. Click "Start" to begin opening tabs, "Stop" to halt operations, or "Reset" to clear fields.
  5. Monitor the status, progress bar, and cycle count for real-time updates.

Advanced Tab

• Purpose: Customize Google Chrome browser options.
• How to Use:
  1. Enable options like headless mode, incognito, or disable GPU/extensions.
  2. Set a custom user agent or enable proxy settings with an IP:PORT address.
  3. Add additional Chrome command-line arguments (one per line).
  4. These settings apply to all instances when starting a task.

Settings Tab

• Purpose: Customize the application’s appearance and behavior.
• How to Use:
  1. Select a theme (e.g., Dark Navy, Soft Pink) or adjust font size (8–24 pt).
  2. Choose a language (English, Japanese, Korean, Chinese, Filipino).
  3. Enable auto-start or lock window size options.
  4. Save or load settings, export logs, or clear the log viewer.

System Tab

• Purpose: Monitor system resources.
• How to Use:
  1. View real-time CPU, memory, and disk usage percentages using psutil.
  2. Check detailed system information (OS, processor, RAM, etc.).
  3. Use this tab to ensure your system can handle multiple browser instances.

Logs Tab

• Purpose: View and manage application logs.
• How to Use:
  1. Monitor color-coded logs (INFO, WARNING, ERROR) with timestamps.
  2. Filter logs by level (e.g., show only errors) using checkboxes.
  3. Export logs to a text file or clear the log viewer.

About Tab

• Purpose: Access application and licensing information.
• How to Use:
  1. View details about the application, including version and developer info.
  2. Check the MIT License details via a clickable link.
  3. Find links to the GitHub repository and Support channels.

Screenshots

Here are previews of the main tabs in Advanced Tab Manager Pro:

Main Tab	Advanced Tab
Settings Tab	System Tab
Logs Tab	About Tab (Coming Soon)

Note: Screenshots assume the presence of assets/screenshots/ directory in the repository. Ensure these files exist or update paths in README.md accordingly.

Releases

• Windows: Pre-compiled .exe (portable) or .msi (installer) tagged with [W] for Windows, available in the Releases section.
• macOS: Pre-compiled universal .dmg (x86_64 and Apple Silicon) tagged with [M] for macOS, available in the Releases section.
• Linux: Pre-compiled .rpm (for Fedora/Red Hat), .deb (for Debian/Ubuntu), or .pkg.tar.zst (for Arch/Pacman) tagged with [L] for Linux, available in the Releases section.
• Check release notes for details on new features, bug fixes, and version updates.
• The Python source (app.py) remains the primary method, supporting all platforms with proper setup.

Support

For ways to get help, report issues, or support the project’s development, please see the following:

• Issues: Report bugs or suggest features on the Issues page.
• Discussions: Join community discussions on the Discussions page.
• Email: Contact the developer at [email protected] for private inquiries.
• Ko-fi: Support the project financially at ko-fi.com/izeno.

Contributing

Advanced Tab Manager Pro is open-source, and contributions are encouraged! Please read our Contributing Guidelines, Code of Conduct, and Security Policy before submitting issues or pull requests. Use the appropriate issue templates for reporting bugs, suggesting features, or other contributions, and the Pull Request template for code submissions.

1. Fork the repository at VoxDroid/Advanced-Tab-Manager.

2. Clone your fork:

   git clone https://github.com/VoxDroid/Advanced-Tab-Manager.git

3. Create a branch:

   git checkout -b feature/your-feature

4. Make changes and commit:

   git add .
   git commit -m "Describe your changes"

5. Push to your fork:

   git push origin feature/your-feature

6. Open a Pull Request on GitHub.

Security

If you discover a security vulnerability, please follow our Security Policy by emailing [email protected] or using the Security Report issue template on the Issues page for non-sensitive issues.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Dependencies

To build from source, install the following Python packages:

• PyQt6 (for the GUI)
• selenium (for browser automation)
• psutil (for system monitoring)
• qtawesome (for icons)
• webdriver-manager (for ChromeDriver management)
• requests (for HTTP requests)
• packaging (for version parsing)

Create a requirements.txt file with these dependencies and run:

pip install -r requirements.txt

---

Developed by VoxDroid
GitHub | Ko-fi

---