https://github.com/awrsha/music-player-and-fountain-control-system
A Qt-based application for synchronized music playback and fountain control
https://github.com/awrsha/music-player-and-fountain-control-system
audio-player cpp dmx-protocol light-controller pattern-selection qt raspberry-pi sqlite3 synchronization
Last synced: 7 months ago
JSON representation
A Qt-based application for synchronized music playback and fountain control
- Host: GitHub
- URL: https://github.com/awrsha/music-player-and-fountain-control-system
- Owner: Awrsha
- License: apache-2.0
- Created: 2024-08-18T14:39:52.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-03-26T23:01:17.000Z (7 months ago)
- Last Synced: 2025-03-27T00:19:34.881Z (7 months ago)
- Topics: audio-player, cpp, dmx-protocol, light-controller, pattern-selection, qt, raspberry-pi, sqlite3, synchronization
- Language: C++
- Homepage:
- Size: 2.91 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎵 FountainPlayer - Music & Fountain Control System
Modern Music Player with Fountain Control Capabilities
A Qt-based application for synchronized music playback and fountain control
[](LICENSE)
[](https://www.qt.io/)
[]()
## 🎯 Features
### Music Player
```mermaid
graph LR
A[Audio Player] --> B[Playlist Management]
A --> C[Multiple Play Modes]
A --> D[Volume Control]
B --> E[Add/Remove Tracks]
B --> F[Create Playlists]
C --> G[Single]
C --> H[Repeat]
C --> I[Random]
```
### Fountain Control
```mermaid
graph TD
A[Fountain Control] --> B[DMX Protocol]
A --> C[Hardware Interface]
B --> D[Light Control]
B --> E[Water Patterns]
C --> F[Raspberry Pi]
C --> G[Custom Hardware]
```
## 🏗 System Architecture
### Component Structure
```mermaid
classDiagram
MainWindow --> BottomBar
MainWindow --> MusicPage
MainWindow --> FountainPlayer
FountainPlayer --> MyPlayer
FountainPlayer --> DMX_Controller
class MainWindow{
+init()
+setupUI()
}
class FountainPlayer{
+playMusic()
+controlFountain()
}
```
## 💾 Project Structure
```
FountainPlayer/
├── src/
│ ├── core/ # Core functionality
│ │ ├── main.cpp
│ │ ├── myplayer.cpp
│ │ └── fountainplayer.cpp
│ ├── ui/ # User interface
│ │ ├── mainwindow.cpp
│ │ ├── bottombar.cpp
│ │ └── musicpage.cpp
│ ├── hardware/ # Hardware control
│ │ ├── RPI_DMX.c
│ │ └── RPI.c
│ └── util/ # Utilities
├── res/ # Resources
│ ├── icons/
│ └── qdarkstyle/
└── docs/ # Documentation
```
## 🛠 Installation
### Prerequisites
```bash
# Required Software
- Qt 5.12 or higher
- C++ Compiler (GCC/MinGW)
- Qt Creator IDE (recommended)
```
### Build Instructions
```bash
# Clone repository
git clone https://github.com/yourusername/FountainPlayer.git
cd FountainPlayer
# Using qmake
qmake FountainPlayer.pro
make
# Or open in Qt Creator
open FountainPlayer.pro
```
## 🎮 Usage
### Media Controls
| Key | Function |
|-----|----------|
| Space | Play/Pause |
| Ctrl+N | Next Track |
| Ctrl+P | Previous Track |
| Ctrl+M | Mute |
| Ctrl+R | Toggle Repeat |
### Fountain Controls
| Control | Description |
|---------|-------------|
| Pattern Selection | Choose water patterns |
| DMX Configuration | Set DMX channels |
| Synchronization | Music-fountain sync |
## 🔧 Configuration
### Hardware Setup
```cpp
// DMX configuration example
#define DMX_PIN 18
#define DMX_CHANNELS 512
// Initialize DMX
RPI_DMX_Init(DMX_PIN, DMX_CHANNELS);
```
### Software Settings
```ini
[General]
DefaultPlayMode=single
Volume=75
LastPlaylist=default
[Fountain]
DMXEnabled=true
Channels=16
Pattern=1
```
## 📦 Dependencies
- Qt 5.12+
- QtMultimedia
- QtSQL
- BCM2835 (for Raspberry Pi)
## 🤝 Contributing
We welcome contributions! Here's how you can help:
1. Fork the repository
2. Create a feature branch
3. Implement your changes
4. Submit a pull request
### Coding Standards
```cpp
class MyClass {
public:
explicit MyClass();
void doSomething();
private:
int m_memberVariable;
};
```
## 📄 License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
## 🛡 Security
- Input validation for all file operations
- Secure hardware access controls
- Protected memory management
## 🔍 Troubleshooting
### Common Issues
1. DMX connection problems
2. Audio playback issues
3. Database connectivity
### Solutions
Check our [Wiki](wiki) for detailed solutions