Update README.md

Author: airobinnet

README.md

@@ -1,150 +1,120 @@
 # Drone HUD Editor
 
-A professional heads-up display (HUD) overlay editor for DJI drone videos, integrating telemetry data from SRT files. Create stunning, data-rich video overlays with real-time flight information.
-
-![Drone HUD Editor Screenshot](screenshots/demo.png) *Drone HUD Editor*
-
-## Features
-
-### Video Playback
-- Automatic window sizing to fit video content
-- Maintains aspect ratio while maximizing screen usage
-- Smooth playback with frame buffering
-- Interactive timeline slider with markers
-- Audio playback support
-
-### HUD Elements
-- **Compass**: Dynamic heading indicator with cardinal directions
-- **Speedometer**: Digital and analog speed display
-- **Camera Settings**: ISO and shutter speed overlay
-- **GPS Coordinates**: 6-decimal precision location display
-- **Altitude**: Height and vertical speed indicators
-- **Center Crosshair**: Precision aiming guide
-- **Interactive Map**: Real-time position tracking with flight path
-- **Horizontal Compass**: Intuitive navigation bar
-- All elements can be toggled individually
-
-### Themes
-- Multiple built-in themes:
+Transform your DJI drone footage with professional heads-up display (HUD) overlays using original flight telemetry data. Create cinematic drone videos with real-time speed, altitude, GPS coordinates, and dynamic mapping.
+
+![Drone HUD Editor Screenshot](screenshots/demo.png)
+
+## ✨ Key Features
+
+### 🎥 Video Processing
+- Smart preview generation for smooth playback
+- Hardware-accelerated video processing
+- Custom start/end markers for export
+- Background music integration with YouTube support
+
+### 🎮 HUD Elements
+- Dynamic speedometer with adjustable scale
+- 3D compass with cardinal directions
+- Real-time GPS coordinates and altitude
+- Interactive mini-map with flight path
+- Camera settings display (ISO, shutter)
+- Customizable crosshair
+- Horizontal compass bar
+- All elements individually toggleable
+
+### 🎨 Themes & Customization
+- 4 Professional themes:
   - Default Green
   - Military
   - Modern Blue
   - Night Vision
-- Customizable colors and opacity
-- High-contrast text with shadows for better visibility
-
-### Telemetry Processing
-- Automatic SRT file detection and parsing
-- Real-time speed calculation from GPS data
-- Vertical speed from altitude changes
-- Heading calculation from coordinate changes
-- Smoothed data using weighted moving averages
-
-### Export Capabilities
-- Export video with permanent HUD overlay
-- Optional background music integration
-- Maintains original video quality
-- Progress tracking during export
-- Cancellable export process
-
-## Installation
-
-1. Clone the repository:
+- Adjustable opacity
+- High-contrast text with shadows
+
+### 🎵 Audio Features
+- Local audio file support (MP3, WAV, M4A)
+- Direct YouTube audio import
+- Volume control with crossfading
+- Audio preview during editing
+
+## 🚀 Quick Start
+
+### Prerequisites
+- Python 3.8 or higher
+- Git (for cloning)
+
+### Installation
+
+1. Clone and enter directory:
 ```bash
 git clone https://github.com/airobinnet/DroneHUDEditor.git
 cd DroneHUDEditor
 ```
 
-1a. (Optional) Create a new virtual environment:
+2. Create virtual environment (recommended):
 ```bash
 python -m venv venv
-source venv/bin/activate
+source venv/bin/activate  # On Windows: venv\Scripts\activate
 ```
 
-2. Install required dependencies:
-
+3. Install dependencies:
 ```bash
 pip install -r requirements.txt
 ```
 
+### Running the App
 
-## Usage
-
-1. **Launch the Application**:
 ```bash
 python main.py
 ```
 
+## 📖 Basic Usage
 
+1. **Load Content**
+   - Click "Load Video" or drag & drop
+   - SRT files are auto-detected
+   - Add background music (optional)
 
-2. **Load Video**:
-   - Click "Load Video" or drag and drop
-   - The app automatically detects matching SRT files
-   - Window resizes to optimal viewing size
+2. **Customize HUD**
+   - Toggle elements with checkboxes
+   - Choose theme from dropdown
+   - Adjust speedometer range
+   - Real-time preview updates
 
-3. **Customize HUD**:
-   - Toggle elements using checkboxes
-   - Select theme from dropdown
-   - Adjust speedometer scale
-   - Changes appear in real-time
+3. **Export**
+   - Set start/end markers (optional)
+   - Click "Export"
+   - Choose quality settings
+   - Add background music
+   - Monitor progress
 
-4. **Playback Controls**:
-   - Play/Pause button
-   - Timeline scrubbing
-   - Set start/end markers for export
-   - Volume control
+## 🛠 Technical Details
 
-5. **Export**:
-   - Click "Export" to save with HUD
-   - Optional: Add background music
-   - Choose output location
-   - Monitor export progress
+- Built with PyQt6 and OpenCV
+- Multi-threaded frame processing
+- Efficient frame buffering
+- OpenStreetMap integration
+- Hardware acceleration support
 
-## Requirements
+## 🤝 Contributing
 
-- Python 3.8+
-- OpenCV
-- PyQt6
-- NumPy
-- Pygame (for audio)
-- Folium (for maps)
-- MoviePy (for export)
-
-See `requirements.txt` for complete list.
-
-## Technical Details
-
-- Built with PyQt6 for the user interface
-- Uses OpenCV for video processing
-- Multithreaded frame reading and processing
-- Efficient frame buffering system
-- Smooth data interpolation for telemetry
-- OpenStreetMap integration for mapping
-
-## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
+Contributions welcome! Please:
 
 1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
-3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
-4. Push to the branch (`git push origin feature/AmazingFeature`)
-5. Open a Pull Request
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+2. Create feature branch (`git checkout -b feature/Amazing`)
+3. Commit changes (`git commit -m 'Add Amazing Feature'`)
+4. Push to branch (`git push origin feature/Amazing`)
+5. Open Pull Request
 
-## Acknowledgments
+## 📄 License
 
-- OpenStreetMap for map data
-- DJI for SRT telemetry format
-- PyQt team for the GUI framework
-- OpenCV team for video processing capabilities
+MIT License - see [LICENSE](LICENSE) file
 
-## Support
+## 💡 Support
 
-If you encounter any issues or have questions, please file an issue on the GitHub repository.
+- Issues: Use GitHub issue tracker
+- Questions: Open a discussion
+- Updates: Watch repository for releases
 
 ---
-Made with ❤️ for drone pilots and video editors
+Made with ❤️ by drone enthusiasts, for drone enthusiasts