Akhil Kumar Alampally commited on
Commit
6b7d4c5
ยท
1 Parent(s): da6fc1c

Update README with detailed documentation and add .gitignore

Browse files
Files changed (2) hide show
  1. .gitignore +49 -0
  2. README.md +73 -25
.gitignore ADDED
@@ -0,0 +1,49 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Python
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+ *.so
6
+ .Python
7
+ build/
8
+ develop-eggs/
9
+ dist/
10
+ downloads/
11
+ eggs/
12
+ .eggs/
13
+ lib/
14
+ lib64/
15
+ parts/
16
+ sdist/
17
+ var/
18
+ wheels/
19
+ *.egg-info/
20
+ .installed.cfg
21
+ *.egg
22
+
23
+ # Virtual Environment
24
+ venv/
25
+ ENV/
26
+
27
+ # IDE
28
+ .idea/
29
+ .vscode/
30
+ *.swp
31
+ *.swo
32
+
33
+ # OS generated files
34
+ .DS_Store
35
+ .DS_Store?
36
+ ._*
37
+ .Spotlight-V100
38
+ .Trashes
39
+ ehthumbs.db
40
+ Thumbs.db
41
+
42
+ # Temp files
43
+ *.tmp
44
+ *.temp
45
+
46
+ # Cache and output directories
47
+ /tmp/
48
+ /cache/
49
+ /output/
README.md CHANGED
@@ -2,31 +2,79 @@
2
 
3
  Extract audio from YouTube/Instagram videos, customize timings, and merge multiple clips with fade effects.
4
 
5
- ## Features
6
- - Extract audio from YouTube and Instagram
7
- - Set custom start/end times
8
- - Reorder tracks
9
- - Adjust fade and delay effects
10
  - Download final merged audio
11
 
12
- ## How to Use
13
- 1. Enter a video URL (YouTube/Instagram)
14
- 2. Set start and end times
15
- 3. Click "Add Track"
16
- 4. Repeat for more tracks
17
- 5. Reorder if needed
18
- 6. Click "Merge Tracks"
19
- 7. Download the result
20
-
21
- ## Note
22
- - Processing may take time for longer videos
23
- - For best results, keep individual clips under 10 minutes
24
- - Output files are stored temporarily and will be deleted after the session ends
25
-
26
- ## Local Development
27
- ```bash
28
- git clone [your-repo-url]
29
- cd audio-extractor
30
- pip install -r hf_requirements.txt
31
- python hf_app.py
 
 
 
 
 
 
 
 
 
 
 
 
32
  ```
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2
 
3
  Extract audio from YouTube/Instagram videos, customize timings, and merge multiple clips with fade effects.
4
 
5
+ ## ๐ŸŒŸ Features
6
+ - Extract audio from YouTube and Instagram videos
7
+ - Set custom start and end times for each clip
8
+ - Merge multiple audio tracks into one file
9
+ - Simple and intuitive interface
10
  - Download final merged audio
11
 
12
+ ## ๐Ÿš€ How to Use
13
+ 1. Enter a video URL (supports YouTube and Instagram)
14
+ 2. Set the start and end times for the clip
15
+ 3. Click "Add Track" to add it to your playlist
16
+ 4. Repeat for additional tracks
17
+ 5. Reorder tracks using drag and drop if needed
18
+ 6. Click "Merge Tracks" to combine all tracks
19
+ 7. Download the final merged audio file
20
+
21
+ ## โš ๏ธ Important Notes
22
+ - **Temporary Storage**: This is a temporary session. All files and data will be deleted when you leave the page.
23
+ - **Clip Length**: For best results, keep individual clips under 10 minutes
24
+ - **Processing Time**: Longer videos may take more time to process
25
+ - **Supported Sites**: Works with most YouTube and Instagram video URLs
26
+
27
+ ## ๐Ÿ› ๏ธ Hugging Face Space Configuration
28
+
29
+ This app is configured to run on Hugging Face Spaces with the following settings:
30
+
31
+ ```yaml
32
+ # This Space runs on Python 3.10 with Gradio
33
+ # The following configuration is automatically handled by Hugging Face
34
+ app_file: app.py
35
+ requirements:
36
+ - pytube==15.0.0
37
+ - moviepy==1.0.3
38
+ - pydub==0.25.1
39
+ - gradio>=3.50.2,<4.0.0
40
+ - python-dotenv==1.0.0
41
+ - numpy==1.26.4
42
+ - yt-dlp==2023.11.16
43
+ - ffmpeg-python==0.2.0
44
  ```
45
+
46
+ ## ๐Ÿ–ฅ๏ธ Local Development
47
+
48
+ 1. Clone the repository:
49
+ ```bash
50
+ git clone https://huggingface.co/spaces/awesome-akhil/auto-extractor-merger
51
+ cd auto-extractor-merger
52
+ ```
53
+
54
+ 2. Create and activate a virtual environment (recommended):
55
+ ```bash
56
+ python -m venv venv
57
+ source venv/bin/activate # On Windows: .\venv\Scripts\activate
58
+ ```
59
+
60
+ 3. Install the required dependencies:
61
+ ```bash
62
+ pip install -r requirements.txt
63
+ ```
64
+
65
+ 4. Run the application:
66
+ ```bash
67
+ python app.py
68
+ ```
69
+
70
+ 5. Open your browser and navigate to `http://localhost:7860`
71
+
72
+ ## ๐Ÿ“ License
73
+
74
+ This project is open source and available under the [MIT License](LICENSE).
75
+
76
+ ## ๐Ÿ™ Credits
77
+
78
+ - Built with [Gradio](https://gradio.app/)
79
+ - Audio processing with [pydub](https://github.com/jiaaro/pydub)
80
+ - Video downloading with [yt-dlp](https://github.com/yt-dlp/yt-dlp)