Spaces:
Running
Running
Commit
Β·
108e52e
1
Parent(s):
c9c6048
update readme
Browse files- .idea/vcs.xml +0 -1
- README.md +10 -121
.idea/vcs.xml
CHANGED
@@ -2,6 +2,5 @@
|
|
2 |
<project version="4">
|
3 |
<component name="VcsDirectoryMappings">
|
4 |
<mapping directory="$PROJECT_DIR$" vcs="Git" />
|
5 |
-
<mapping directory="$PROJECT_DIR$/Music_Splitter" vcs="Git" />
|
6 |
</component>
|
7 |
</project>
|
|
|
2 |
<project version="4">
|
3 |
<component name="VcsDirectoryMappings">
|
4 |
<mapping directory="$PROJECT_DIR$" vcs="Git" />
|
|
|
5 |
</component>
|
6 |
</project>
|
README.md
CHANGED
@@ -1,121 +1,10 @@
|
|
1 |
-
|
2 |
-
|
3 |
-
|
4 |
-
|
5 |
-
|
6 |
-
|
7 |
-
|
8 |
-
|
9 |
-
|
10 |
-
|
11 |
-
- **Video Processing**: Separate vocals from video files (MP4, MKV, AVI)
|
12 |
-
- **Download Options**:
|
13 |
-
- Download isolated vocals
|
14 |
-
- Download processed video with isolated vocals
|
15 |
-
- **User-Friendly Interface**: Simple drag-and-drop file upload
|
16 |
-
- **Multiple Format Support**: Works with various audio and video formats
|
17 |
-
|
18 |
-
## π Getting Started
|
19 |
-
|
20 |
-
### Prerequisites
|
21 |
-
|
22 |
-
- Docker installed on your system
|
23 |
-
- At least 4GB of available RAM
|
24 |
-
- 2GB of free disk space
|
25 |
-
|
26 |
-
### Quick Start with Docker
|
27 |
-
|
28 |
-
1. Clone the repository:
|
29 |
-
```bash
|
30 |
-
git clone https://github.com/yourusername/Omar-YYoussef-Audio_Video_Music_Splitter.git
|
31 |
-
cd Omar-YYoussef-Audio_Video_Music_Splitter
|
32 |
-
```
|
33 |
-
|
34 |
-
2. Build the Docker image:
|
35 |
-
```bash
|
36 |
-
docker build -t audio-video-splitter .
|
37 |
-
```
|
38 |
-
|
39 |
-
3. Run the container:
|
40 |
-
```bash
|
41 |
-
docker run -p 8501:8501 audio-video-splitter
|
42 |
-
```
|
43 |
-
|
44 |
-
4. Open your browser and navigate to:
|
45 |
-
```
|
46 |
-
http://localhost:8501
|
47 |
-
```
|
48 |
-
|
49 |
-
### Manual Installation
|
50 |
-
|
51 |
-
1. Install system dependencies:
|
52 |
-
```bash
|
53 |
-
# Ubuntu/Debian
|
54 |
-
sudo apt-get update && sudo apt-get install -y ffmpeg
|
55 |
-
|
56 |
-
# MacOS
|
57 |
-
brew install ffmpeg
|
58 |
-
|
59 |
-
# Windows
|
60 |
-
# Download and install ffmpeg from https://ffmpeg.org/download.html
|
61 |
-
```
|
62 |
-
|
63 |
-
2. Install Python dependencies:
|
64 |
-
```bash
|
65 |
-
pip install -r requirements.txt
|
66 |
-
```
|
67 |
-
|
68 |
-
3. Run the application:
|
69 |
-
```bash
|
70 |
-
streamlit run main.py
|
71 |
-
```
|
72 |
-
|
73 |
-
## π‘ Usage
|
74 |
-
|
75 |
-
### Processing Audio Files
|
76 |
-
|
77 |
-
1. Select the "Audio Processing π§" tab
|
78 |
-
2. Upload your audio file (MP3, WAV, or OGG format)
|
79 |
-
3. Click "Process Audio"
|
80 |
-
4. Download the separated vocals
|
81 |
-
|
82 |
-
### Processing Video Files
|
83 |
-
|
84 |
-
1. Select the "Video Processing π₯" tab
|
85 |
-
2. Upload your video file (MP4, MKV, or AVI format)
|
86 |
-
3. Click "Process Video"
|
87 |
-
4. Download either:
|
88 |
-
- The processed video with isolated vocals
|
89 |
-
- The separated vocals as an audio file
|
90 |
-
|
91 |
-

|
92 |
-
|
93 |
-
|
94 |
-
## π§ Technical Details
|
95 |
-
|
96 |
-
The application uses several key technologies:
|
97 |
-
|
98 |
-
- **Streamlit**: For the web interface
|
99 |
-
- **Demucs**: For audio source separation
|
100 |
-
- **FFmpeg**: For audio/video processing
|
101 |
-
- **Python 3.9**: As the base programming language
|
102 |
-
|
103 |
-
|
104 |
-
## π€ Contributing
|
105 |
-
|
106 |
-
1. Fork the repository
|
107 |
-
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
|
108 |
-
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
|
109 |
-
4. Push to the branch (`git push origin feature/AmazingFeature`)
|
110 |
-
5. Open a Pull Request
|
111 |
-
|
112 |
-
## π License
|
113 |
-
|
114 |
-
This project is licensed under the MIT License - see the LICENSE file for details.
|
115 |
-
|
116 |
-
## π Acknowledgments
|
117 |
-
|
118 |
-
- [Demucs](https://github.com/facebookresearch/demucs) for the audio separation model
|
119 |
-
- [Streamlit](https://streamlit.io/) for the web app framework
|
120 |
-
- [FFmpeg](https://ffmpeg.org/) for media processing capabilities
|
121 |
-
|
|
|
1 |
+
---
|
2 |
+
title: "Vocal Separator"
|
3 |
+
emoji: "π΅"
|
4 |
+
colorFrom: "blue"
|
5 |
+
colorTo: "purple"
|
6 |
+
sdk: streamlit
|
7 |
+
sdk_version: "1.20.0" # Replace with the latest Streamlit version
|
8 |
+
app_file: app.py
|
9 |
+
pinned: false
|
10 |
+
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|