apunkt/ASCILINE
1
0
Fork 0
mirror of https://github.com/YusufB5/ASCILINE.git synced 2026-06-17 22:35:13 +02:00
Code Issues Projects Releases Packages Wiki Activity

feat: server-side volume control feature added, playlist & folder video management

Browse source
This commit is contained in:
YusufB5 2026-06-04 16:14:23 +03:00
parent fd422b5100
commit 5fad7c5aa9
6 changed files with 344 additions and 101 deletions
Download patch file Download diff file Expand all files Collapse all files

48
README.md
View file

@ -46,10 +46,27 @@ pip install fastapi uvicorn opencv-python numpy websockets
```
### 3. Run the Web Server
Place a `video.mp4` in the root directory and start the server:
**Single video:**
```bash
python stream_server.py
python stream_server.py video.mp4
```
**Folder mode — drop your videos into `videos/` and run:**
```bash
python stream_server.py --folder videos
python stream_server.py --folder videos --loop # infinite loop
python stream_server.py --folder videos --mode 5 --vol 2 # all videos same settings
```
Videos play in **filesystem order** (top to bottom as they appear in the folder, not alphabetically). Just add/remove files from the `videos/` folder to control the queue.
**JSON Playlist — full control per video:**
```bash
python stream_server.py --playlist playlist.json
python stream_server.py --playlist playlist.json --loop
```
Use `playlist.json` when you need different `--mode` or `--vol` settings for each video.
Open `http://localhost:8000` in your browser.
### 4. Run directly in Terminal (Standalone)
@ -83,6 +100,33 @@ The engine supports different fidelity levels via the `--mode` flag:
python stream_server.py --mode 5 --cols 240 --rows 100
```
### Server-Side Volume Control
Volume is controlled at the server level via the `--vol` flag (scale 0–5).
When set to `0`, the audio engine (FFmpeg) **never runs**, saving CPU and bandwidth.
| `--vol` | FFmpeg Multiplier | Description |
|---------|------------------|-------------|
| `0` | — | Muted (no processing) |
| `1` | 1.0× | Normal (default) |
| `3` | 1.5× | Loud |
| `5` | 2.0× | Double volume |
```bash
python stream_server.py video.mp4 --vol 0 # Silent
python stream_server.py video.mp4 --vol 3 # Loud
```
### Playlist Format (`playlist.json`)
Each entry can override the global `--mode` and `--vol` defaults:
```json
[
{ "video": "intro.mp4", "mode": 1, "vol": 1 },
{ "video": "main.mp4", "mode": 5, "vol": 3 },
{ "video": "outro.mp4", "mode": 3, "vol": 2 }
]
```
Video paths are resolved automatically — the engine checks the project root and the `videos/` subfolder, so you can write just the filename.
## 📜 License & Ethical Guardrails
**MIT License (with Anti-Ad Restriction)**