Omar-youssef commited on
Commit
108e52e
Β·
1 Parent(s): c9c6048

update readme

Browse files
Files changed (2) hide show
  1. .idea/vcs.xml +0 -1
  2. 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
- # 🎡 Audio/Video Music Splitter
2
-
3
- A Streamlit-based web application that allows users to separate vocals from audio files and videos. This tool uses the Demucs model for high-quality audio source separation.
4
-
5
- ![Screenshot 2025-01-10 150722](https://github.com/user-attachments/assets/5d74204f-0c54-44c3-acb9-e3eaa633ded7)
6
-
7
-
8
- ## 🌟 Features
9
-
10
- - **Audio Processing**: Extract vocals from audio files (MP3, WAV, OGG)
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
- ![Screenshot 2025-01-10 150909](https://github.com/user-attachments/assets/755dc95c-bbeb-4356-a3af-2c2694cd5fd8)
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
+ ---