YouTube-Scissors CLI
A simple CLI app that allows you to divide a YouTube video into multiple separate videos base on a video's time stamps. This project is built on top of another one of my projects, yt-scissors.
💡
Features
-
Can generate multiple videos or extract a single video, based on a YouTube video's time stamps (time stamps from a comment, video description, or chapters)
-
Important: Generated time stamps from the description and comments works about 85% of the time. Make sure the video's time stamps are spaced out and have nothing that would make it hard to find them. There is also a bug with any video that is +10 hours long, so video length should be below 10 hours.
-
Note: Make sure the description or comment has a full time stamp list for the best results.
-
-
Can download videos directly from CLI
-
Can process already downloaded YouTube videos
-
Simple CLI structure
-
100% Open Source (MIT license)
📂
How to Download & Install
-
Download it here or go to the release tab of this repository.
-
Once you downloaded the YouTube-Scissors-CLI executable, download ffmpeg. FFmpeg Downloads
-
After downloading ffmpeg, open up the config.json file and paste the path to where you have saved the ffmpeg executable. Make sure you put config.json in the same directory as your YouTube-Scissors executable.
-
Edit config.json to your liking.
Example of How config.json is Setup
{
"ffmpeg_path": "Your ffmpeg executable path goes here",
"hide_ffmpeg": true, // hides ffmpeg logs
"hide_yt_download": true, // hides download logs
"hide_logo": false // hides youtube-scissors banner on startup
}
🕹️
Usage
-
Find a YouTube video that you want to extract videos from
-
Make sure the YouTube video has either chapters or time stamps in the description or comments section
-
Note: For comments, follow this tutorial to figure out how to get a YouTube comment's URL.
-
Tip: Make sure the description or comment has a full time stamp list for the best results.
-
-
Run YouTube-Scissors CLI and paste the YouTube video's URL or the YouTube comment's URL
-
Then enter in what you want for each prompt
- Important: When extracting multiple videos, YouTube-scissors will NOT create a folder for all the videos to be saved in. You must create an empty folder beforehand and save all the videos there.
🎥
Video Demo
📷
Screenshots
🛠️
Developer Instructuions (Build From Source)
Most users do not need to build from source. You can download the builds from here.
If you are looking for an API / wrapper library for this CLI app, look here.
What you will need
- Download a copy of ffmpeg
- Have Node.js installed on your system
- (Optional) Have git installed on your system
How To Build From Source
(Step 1) Download the source code and cd into it
git clone https://github.com/Guuzzeji/youtube-scissors-cli.git
cd youtube-scissors-cli
(Step 2) Install pkg (Learn more about pkg)
npm install -g pkg
(Step 3) Then run npm install to install all needed dependencies
npm install
(Step 4) Build using npm
npm run build
(Step 5) Setting up config.json
cd build
- cd into the build directory and copy the config.json file into it. Make sure you edit the config.json file to your liking and type in the path to your ffmpeg executable.
🤝
How to Contribute
-
Fork the main branch
-
Open your fork and add your changes / features / bug fixes
-
(Important) Run
npm testif you made any changes to fetch folder or fetch files. You need to do this to make sure everything is working properly when grabbing data and parsing it from YouTube -
(Important) Test and make sure your changes can still create a functional executable file. (check the build guide above)
-
Create a pull request
- Make sure to add a description of what changes you have made and why your changes are important.
Helpful Infomation
License
MIT
2 Dec 28, 2021
33 Dec 27, 2022
3 Mar 23, 2022
2 Dec 15, 2022
6 Mar 29, 2022
58 Jan 3, 2023
45 Jan 4, 2023
1 Feb 10, 2022
4 Aug 11, 2022
90 Dec 30, 2022
13 Dec 29, 2022
9 Nov 1, 2021
74 Jan 2, 2023
12 Oct 18, 2022
86 Dec 18, 2022
7 May 23, 2022
22 Nov 1, 2022
3 Jun 17, 2022
12 Jul 21, 2022