ks-tools/README.md
2023-03-10 19:46:37 +01:00

166 lines
6.0 KiB
Markdown

ks-tools - Tools for upload, convert and crop/mix video/audio files.
====================================================================
### Documentation:
* `Tools for upload:`
* [ks-upv](doc/ks-upv.md) - Upload video file(s) to server with scp or rsync.
* [ks-upa](doc/ks-upa.md) - Upload audio file(s) to server with scp or rsync.
* [ks-upf](doc/ks-upf.md) - Upload common file(s) to server with scp or rsync.
* [ks-upr](doc/ks-upr.md) - Upload recursively file(s) to server with scp or rsync.
* `Tools for convert video:`
* [ks-mp4](doc/ks-mp4.md) - Convert video file to compact and efficient MP4 (libx264 + aac).
* [ks-mp4k](doc/ks-mp4k.md) - Convert video file to compact and efficient MP4 (4K).
* [ks-mp4s](doc/ks-mp4s.md) - Convert video file to compact and efficient MP4 (Series).
* [ks-mp4s-folder](doc/ks-mp4s-folder.md) - Convert videos from folder to MP4 format (Series).
* [ks-avi](doc/ks-avi.md) - Convert video file to compact and efficient AVI (libxvid + mp3).
* [ks-vob](doc/ks-vob.md) - Convert video file to VOB (DVD splitet) format.
* [ks-av1](doc/ks-av1.md) - Convert video file to compact and efficient AV1 codec (libsvtav1 + libvorbis).
* [ks-av1s](doc/ks-av1s.md) - Convert video file to compact and efficient AV1 codec (Series).
* `Tools for convert audio:`
* [ks-oga](doc/ks-oga.md) - Convert video/audio file to OGA (OGG Audio) Format.
* [ks-oga-album](doc/ks-oga-album.md) - Convert folder album to OGA (OGG Audio) Format.
* [ks-mp3](doc/ks-mp3.md) - Convert video/audio file to MP3 Audio Format.
* [ks-mp3-album](doc/ks-mp3-album.md) - Convert folder album to MP3 Audio Format.
* `Tools for crop/mix video/audio:`
* [ks-mix](doc/ks-mix.md) - Extract video/audio and mix video/audio files.
* [ks-crop](doc/ks-crop.md) - Crop or change aspect ratio of a video.
* `Wrappers/Configuration:`
* [ks-mp4-wrapper](doc/ks-mp4-wrapper.md) - Wrapper for ks-mp4 to create graphical interfaces.
* [ks-mp4k-wrapper](doc/ks-mp4k-wrapper.md) - Wrapper for ks-mp4k to create graphical interfaces.
* [ks-mp4s-wrapper](doc/ks-mp4s-wrapper.md) - Wrapper for ks-mp4s to create graphical interfaces.
* [ks-avi-wrapper](doc/ks-avi-wrapper.md) - Wrapper for ks-avi to create graphical interfaces.
* [ks-vob-wrapper](doc/ks-vob-wrapper.md) - Wrapper for ks-vob to create graphical interfaces.
* [ks-conf](doc/ks-conf.md) - Tool for create and modify all configuration files.
### Installation:
* **GNU/Linux:**
* Install dependencies **(for Arch Linux)**:
```shell
$ sudo pacman -Syu git make expect rsync openssh sshpass grep coreutils binutils
````
* Install dependencies **(for Ubuntu/Debian)**:
```shell
$ sudo apt install git make expect rsync openssh-client openssh-server sshpass grep binutils
````
* Install dependencies **(for Fedora)**:
```shell
$ sudo dnf install git make expect rsync openssh sshpass grep coreutils binutils
````
* Install `ffmpeg` from repository or use the package [ffmpeg-6.0-linux-gnu-64bit-build2.tar.bz2](https://drive.proton.me/urls/87E226C29C#mcuvbx0p6DLy):
```shell
$ sudo tar jxvf ffmpeg-6.0-linux-gnu-64bit-build2.tar.bz2 -C /
````
* Install ks-tools cloning the repository:
```shell
$ git clone https://gitlab.com/q3aql/ks-tools
$ cd ks-tools
$ make install
````
* **Windows ([Cygwin](https://www.cygwin.com/)):**
* Install dependencies:
```shell
$ lynx -source rawgit.com/transcode-open/apt-cyg/master/apt-cyg > apt-cyg
$ install apt-cyg /bin
$ apt-cyg install git make expect rsync openssh sshpass grep coreutils binutils
````
* Download package [ffmpeg-6.0-cygwin-64bit-build2.tar.gz](https://drive.proton.me/urls/87E226C29C#mcuvbx0p6DLy) and install it:
```shell
$ tar zxvf ffmpeg-6.0-cygwin-64bit-build2.tar.gz -C /
````
* If you prefer your own ffmpeg build, use this script for build it:
```shell
$ git clone https://gitlab.com/q3aql/ks-tools
$ cd ks-tools/cygwin
$ chmod +x ffmpeg-build-cygwin64.sh
$ ./ffmpeg-build-cygwin64.sh
````
* Install ks-tools cloning the repository:
```shell
$ git clone https://gitlab.com/q3aql/ks-tools
$ cd ks-tools
$ make -f Makefile.Cygwin
````
* **Windows ([WSL](https://learn.microsoft.com/en-us/windows/wsl/install)):**
* Install dependencies:
```shell
$ sudo apt install git make expect rsync openssh-client openssh-server sshpass grep binutils
````
* Install `ffmpeg` from the package [ffmpeg-6.0-linux-gnu-64bit-build2.tar.bz2](https://drive.proton.me/urls/87E226C29C#mcuvbx0p6DLy) or from repository:
```shell
$ sudo apt install ffmpeg
````
* Install ks-tools cloning the repository:
```shell
$ git clone https://gitlab.com/q3aql/ks-tools
$ cd ks-tools
$ make install
````
* **MacOS ([HomeBrew](https://brew.sh/)):**
* Install dependencies:
```shell
$ brew install git make expect rsync openssh grep binutils ffmpeg
$ curl -L https://raw.githubusercontent.com/kadwanev/bigboybrew/master/Library/Formula/sshpass.rb > sshpass.rb
$ brew install sshpass.rb
````
* Install ks-tools cloning the repository:
```shell
$ git clone https://gitlab.com/q3aql/ks-tools
$ cd ks-tools
$ make install
````
### External links:
* [ffmpeg homepage](http://ffmpeg.org/)
* [rsync homepage](https://rsync.samba.org/)
* [OpenSSH homepage](https://www.openssh.com/)
* [Cygwin homepage](https://www.cygwin.com/)
* [xterm homepage](https://invisible-island.net/xterm/)
* [Coreutils homepage](https://www.gnu.org/software/coreutils/coreutils.html)
* [Bash homepage](https://www.gnu.org/software/bash/)
* [Grep homepage](https://www.gnu.org/software/grep/)