Skip to content

Commit 9d3a957

Browse files
authored
Update README.md
1 parent 9589443 commit 9d3a957

File tree

1 file changed

+48
-63
lines changed

1 file changed

+48
-63
lines changed

README.md

Lines changed: 48 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -1,77 +1,62 @@
1-
2-
31
# SpectrumNet - Real-Time Audio Spectrum Visualizer
42

5-
SpectrumNet is a audio visualization application that transforms real-time audio input into captivating visual spectrums. Built with C# and WPF, it leverages advanced signal processing and modern rendering techniques to provide an immersive experience.
6-
7-
## Key Features
8-
9-
- 🎤 **Real-Time Audio Capture**: Utilizes WASAPI loopback to capture system audio.
10-
- 📊 **FFT Processing**: Supports multiple window functions (Hann, Hamming, Blackman, etc.) for accurate frequency analysis.
11-
- 🎨 **Dynamic Visual Styles**: 20+ rendering styles including bars, waveforms, particles, and Voronoi diagrams.
12-
- ⚙️ **Customizable Visualization**:
13-
- Adjustable spectrum scale (Linear/Logarithmic/Mel/Bark)
14-
- Custom color palettes and gradient effects
15-
- Quality presets (Low/Medium/High)
16-
- 🖥 **Flexible Display Modes**: Switch between windowed mode and always-on-top overlay.
17-
-**Hotkey Support**: Quick control over recording, quality settings, and overlay.
18-
19-
## System Requirements
3+
[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
4+
[![.NET 8.0](https://img.shields.io/badge/.NET-8.0-purple.svg)](https://dotnet.microsoft.com)
205

21-
- Windows 10/11 required
22-
- .NET 8.0 Runtime
23-
- DirectX 9 compatible GPU recommended
24-
25-
## ⚠️ Known Issues
26-
27-
### Transparency Issues on Integrated GPUs (Intel HD)
28-
**When using OpenGL hardware acceleration**, you might encounter:
29-
- Partial loss of window transparency
30-
- Rendering artifacts in overlay mode
31-
- Interface flickering
6+
SpectrumNet transforms real-time audio input into dynamic visual spectrums using C#/WPF. Combines advanced signal processing with modern rendering for immersive audio visualization.
327

33-
**Most commonly occurs on:**
34-
✔️ Older Intel HD Graphics
35-
✔️ Outdated drivers (< 2021)
36-
✔️ Systems with hybrid graphics
8+
![Demo Visualization](https://github.com/user-attachments/assets/52eac8ad-b97c-4395-a998-2fb35c1ca5aa)
9+
![Overlay Mode](https://github.com/user-attachments/assets/bc2052b7-0294-4698-825d-6b2a27fc27d5)
10+
![Visual Settings](https://github.com/user-attachments/assets/b7e5397d-7de5-479f-b2ca-412f57cefa80)
11+
![Performance Settings](https://github.com/user-attachments/assets/260d3634-b1e9-4765-97a3-927aa06404a7)
3712

38-
**Workaround:**
39-
Force dedicated GPU selection in your graphics driver settings.
13+
## ✨ Key Features
4014

41-
- https://github.com/mono/SkiaSharp/issues/2837
15+
### 🎧 Audio Processing
16+
- Real-time system audio capture via WASAPI loopback
17+
- Multi-window FFT analysis (Hann/Hamming/Blackman)
18+
- Flexible spectrum scaling: Linear/Logarithmic/Mel/Bark
4219

43-
⚠️ So i replacing SKGLElement with SKElement in XAML and code.
20+
### 🎨 Visualization Engine
21+
- **20+ Render Styles**:
22+
- Bars: Vertical, Circular, LED Meter
23+
- Waveforms: Gradient, Heartbeat, Waterfall
24+
- Particles: Fire, Raindrop, Text Effects
25+
- Advanced: Voronoi diagrams, Spectrum fractals
26+
- Dynamic color palettes with gradient effects
27+
- Quality presets (Low/Medium/High) with manual override
4428

45-
- Since SKElement doesn't support OpenGL hardware acceleration, rendering performance may decrease for some effects in renderers.
46-
- I'll leave it until the problems with black screen are solved below.
29+
### ⚙️ Customization & Control
30+
- Display modes: Windowed/Always-on-Top overlay
31+
- Configurable hotkeys (Capture start/stop, Mode toggle)
32+
- Real-time adjustment of spectrum sensitivity/range
4733

48-
## Quick Start
34+
## 🚀 Quick Start
4935

50-
1. **Launch** the application
36+
1. Launch SpectrumNet.exe
5137
2. Click **Start Capture** to begin audio analysis
52-
3. Use **Control+O** to toggle overlay mode
53-
4. Press **Space** to start/stop visualization
54-
5. Adjust settings via **Control Panel** (Control+P)
38+
3. Use hotkeys:
39+
- `Ctrl+O`: Toggle overlay mode
40+
- `Space`: Start/stop visualization
41+
- `Ctrl+P`: Open control panel
42+
4. Adjust settings via interactive preview
5543

56-
## Supported Render Styles
57-
58-
| Bars | Waveforms | Particle Effects |
59-
|----------------|----------------|-------------------|
60-
| Vertical Bars | Gradient Wave | Fire Visualization|
61-
| Circular Bars | Heartbeat | Raindrop Effects |
62-
| LED Meter | Waterfall | Text Particles |
63-
64-
And more...
65-
66-
67-
![Intro](https://github.com/user-attachments/assets/52eac8ad-b97c-4395-a998-2fb35c1ca5aa)
68-
69-
![Working](https://github.com/user-attachments/assets/bc2052b7-0294-4698-825d-6b2a27fc27d5)
70-
71-
![Settings](https://github.com/user-attachments/assets/b7e5397d-7de5-479f-b2ca-412f57cefa80)
72-
73-
![Settings](https://github.com/user-attachments/assets/260d3634-b1e9-4765-97a3-927aa06404a7)
44+
## ⚠️ Known Issues
7445

75-
## License
46+
### Transparency Rendering Issues (Intel GPUs)
47+
**Symptoms**:
48+
- Partial loss of window transparency
49+
- Visual artifacts in overlay mode
50+
- Interface flickering
7651

77-
MIT License - Free for personal and educational use. See [LICENSE](LICENSE) for details.
52+
**Common Cases**:
53+
- Intel HD Graphics (pre-2021 models)
54+
- Hybrid graphics systems
55+
- Drivers older than 2021
56+
57+
**Workaround**:
58+
1. Force dedicated GPU usage via driver settings
59+
2. Disable OpenGL acceleration:
60+
```xaml
61+
<!-- Replace in XAML -->
62+
<skia:SKElement /> <!-- Instead of SKGLElement -->

0 commit comments

Comments
 (0)