Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/guuzzeji/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. Powered by pkg and yt-scissors library.
https://github.com/guuzzeji/youtube-scissors-cli
cli ffmpeg javascript nodejs video-processing youtube youtube-dl youtube-downloader youtube-video
Last synced: about 1 month ago
JSON representation
A simple cli-app that allows you to divide a YouTube video into multiple separate videos base on a video's time stamps. Powered by pkg and yt-scissors library.
- Host: GitHub
- URL: https://github.com/guuzzeji/youtube-scissors-cli
- Owner: Guuzzeji
- License: mit
- Created: 2022-08-22T19:48:20.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-05-01T13:58:59.000Z (over 1 year ago)
- Last Synced: 2024-09-28T03:21:34.549Z (about 2 months ago)
- Topics: cli, ffmpeg, javascript, nodejs, video-processing, youtube, youtube-dl, youtube-downloader, youtube-video
- Language: JavaScript
- Homepage:
- Size: 1.66 MB
- Stars: 25
- Watchers: 2
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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](https://github.com/Guuzzeji/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
- **Note:** Downloading is slow compare to other YouTube download methods.
- If you need good download speeds try [pytube](https://github.com/pytube/pytube) or [yt-dlp](https://github.com/yt-dlp/yt-dlp). You can still use this program with other YouTube download methods.
- Can process already downloaded YouTube videos
- Simple CLI structure
- 100% Open Source (MIT license)
## đ How to Download & Install
1. Download it [here](https://github.com/Guuzzeji/youtube-scissors-cli/releases) or go to the release tab of this repository.
2. Once you downloaded the YouTube-Scissors-CLI executable, download ffmpeg. [FFmpeg Downloads](https://ffmpeg.org/download.html)
3. 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.
4. Edit config.json to your liking.
**Example of How config.json is Setup**
```js
{
"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
1. 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](https://www.youtube.com/watch?v=PnmfkLiMLHs) 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.
2. Run YouTube-Scissors CLI and paste the YouTube video's URL or the YouTube comment's URL
3. 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](https://github.com/Guuzzeji/youtube-scissors-cli/releases).
> If you are looking for an API / wrapper library for this CLI app, look [here](https://github.com/Guuzzeji/yt-scissors).
### What you will need
- Download a copy of [ffmpeg](https://ffmpeg.org/download.html)
- Have [Node.js](https://nodejs.org/en/) installed on your system
- (Optional) Have [git](https://git-scm.com/downloads) installed on your system
---
### How To Build From Source
**(Step 1) Download the source code and cd into it**
```console
git clone https://github.com/Guuzzeji/youtube-scissors-cli.git
cd youtube-scissors-cli
```
**(Step 2) Install pkg ([Learn more about pkg](https://github.com/vercel/pkg))**
```console
npm install -g pkg
```
**(Step 3) Then run npm install to install all needed dependencies**
```console
npm install
```
**(Step 4) Build using npm**
```console
npm run build
```
**(Step 5) Setting up config.json**
```console
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 test` if 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
- [How to find a YouTube comment URL from a video](https://www.youtube.com/watch?v=PnmfkLiMLHs)
### License
MIT
