smart-bug-tracker ^v1.1.3

Enhanced Single Instance Protection:

• Intelligent Launch Control — Prevents running multiple application instances
• Automatic Focus — New instances automatically bring existing window to front
• Smart Detection — Cross-platform compatibility with multiple fallback methods

Comprehensive Help System:

• Extended Keyboard Shortcuts — Dozens of new keyboard shortcuts for efficiency
• Detailed Help Dialog — Organized, searchable help with categorized shortcuts
• F1 Hotkey — Instant access to help from any window

Advanced Keyboard Navigation:

• Task Management Shortcuts — Quick task status changes (Ctrl+D, Ctrl+P)
• Bug Tracking Shortcuts — Fast bug status updates (Ctrl+Shift+D, Ctrl+Shift+P)
• Tab Navigation — Quick tab switching (Ctrl+1, Ctrl+2, Ctrl+3)
• Search Focus — Instant search field access (Ctrl+F, Ctrl+Shift+F)

Project Structure:

smart-bug-tracker/
├── core/                    # Core application logic
│   ├── models/             # Data models (Bug, Task, Project)
│   ├── managers/           # Business logic managers
│   ├── ui/                 # User interface components
│   │   ├── windows/        # Main application windows
│   │   └── dialogs/        # Modal dialog windows
│   └── utils/              # Utility functions
├── core/data/sounds/       # Sound effects
├── main.py                 # Application entry point
├── README.md               # This file
└── requirements.txt        # Python dependencies

Dependencies:

• PyQt5 — GUI framework
• Python 3.8+ — Runtime environment

Projects are saved as .bugtracker.json files:

{
  "meta": {
    "name": "Project Name",
    "description": "Project description",
    "author": "Your Name",
    "created_at": "2025-01-01T12:00:00",
    "github_url": "https://github.com/username/repo",
    "versions": ["v1.0.0", "v1.1.0"],
    "developers": ["dev1", "dev2"],
    "testers": ["tester1", "tester2"]
  },
  "versions": {
    "v1.0.0": {
      "tasks": { ... },
      "bugs": { ... }
    }
  }
}

Version Sorting: dev → test → alpha → beta → rc → v1.0.0 → v1.0.1 → v1.1.0 → v2.0.0

git clone https://github.com/aixandrolab/smart-bug-tracker.git
cd smart-bug-tracker
pip install -r requirements.txt
python main.py

Version 1.1.3 (Current Release - 2025)

• Added: Single instance protection with smart focus switching
• Added: Comprehensive help system with keyboard shortcuts reference
• Added: Dozens of new keyboard shortcuts for improved productivity
• Added: F1 help hotkey in all application windows
• Enhanced: Cross-platform compatibility and stability
• Improved: Application architecture and code maintainability

Version 1.1.2

• Added: Project editing capabilities for developers
• Added: Automatic version selection on startup
• Added: Sound system with toggle (Ctrl+M)
• Added: Enhanced GitHub integration features

Q: Can I turn off sounds?

Yes! Press Ctrl+M at any time or click the sound button in the header.

Q: What Python version do I need?

Python 3.8 or higher is required.

Q: Where are screenshots stored?

Screenshots are referenced by file path, not embedded. Keep the image files accessible.

Q: Can I export my data for reporting?

Yes! Use the export options in the Statistics tab or File menu.

By using this software, you agree to the full disclaimer terms.

Software provided "AS IS" without warranty. You assume all risks.

Full legal disclaimer: See DISCLAIMER.md

License: MIT License