ztimson/transmute
ztimson/transmute
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Zakary Timson 2023-08-14 18:47:03 +00:00
parent b5966f98b2
commit 9a73b85090
1 changed files with 134 additions and 97 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

231
README.md
View File

@ -1,97 +1,134 @@
![Transmute](./docs/images/logo.png) <!-- Header -->
<div id="top" align="center">
--- <br />
A distributed video transcoder <!-- Logo -->
<img src="https://git.zakscode.com/repo-avatars/b497daaf22a214fe6d6cc35b8ec217cd22401b668dff93dcfcc7557bd8a46d96" alt="Logo" width="200" height="200">
[![Latest Release](https://gitlab.zakscode.com/zakscode/transmute/transmute/-/badges/release.svg)](https://gitlab.zakscode.com/zakscode/transmute/transmute/-/releases)
<!-- Title -->
[![Common](https://gitlab.zakscode.com/zakscode/transmute/common/badges/develop/pipeline.svg?key_text=Common)](https://gitlab.zakscode.com/zakscode/transmute/common) ### Transmute
[![Client](https://gitlab.zakscode.com/zakscode/transmute/client/badges/develop/pipeline.svg?key_text=Client)](https://gitlab.zakscode.com/zakscode/transmute/client)
[![Server](https://gitlab.zakscode.com/zakscode/transmute/server/badges/develop/pipeline.svg?key_text=Server)](https://gitlab.zakscode.com/zakscode/transmute/server) <!-- Description -->
[![Worker](https://gitlab.zakscode.com/zakscode/transmute/worker/badges/develop/pipeline.svg?key_text=Worker)](https://gitlab.zakscode.com/zakscode/transmute/worker) Distributed Video Transcoding
![Placeholder Screenshot](./docs/images/screenshot.png) <!-- Repo badges -->
[![Version](https://img.shields.io/badge/dynamic/json.svg?label=Version&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/Transmute/tags&query=$[0].name)](https://git.zakscode.com/ztimson/Transmute/tags)
Transmute provides a simple web based tool to manage your video library. Transmute will watch a directory and automatically [![Pull Requests](https://img.shields.io/badge/dynamic/json.svg?label=Pull%20Requests&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/Transmute&query=open_pr_counter)](https://git.zakscode.com/ztimson/Transmute/pulls)
transcode videos using [FFmpeg](https://ffmpeg.org/) & hardware acceloration (if available) so that your entire library [![Issues](https://img.shields.io/badge/dynamic/json.svg?label=Issues&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/Transmute&query=open_issues_count)](https://git.zakscode.com/ztimson/template/issues)
meets a specified standard. In addition to transcoding, Transmute can also remove undesired audio tracks, subtitles,
perform healthchecks & upscale/downscale video. <!-- Links -->
---
--- <div>
<a href="https://git.zakscode.com/ztimson/Transmute/wiki" target="_blank">Documentation</a>
> Why do I care? • <a href="https://git.zakscode.com/ztimson/Transmute/releases" target="_blank">Release Notes</a>
• <a href="https://git.zakscode.com/ztimson/Transmute/issues/new?template=.github%2fissue_template%2fbug.md" target="_blank">Report a Bug</a>
1. Transcoding `MPEG-2/MPEG-4` video to `h.264/h.265` can reduce file size by **50-90%** • <a href="https://git.zakscode.com/ztimson/Transmute/issues/new?template=.github%2fissue_template%2fenhancement.md" target="_blank">Request a Feature</a>
2. A more extreme measure is downscaling `4K` to `1080p` to reduce size by a further **75%** </div>
3. Stripping out unused audio tracks & subtitles can result in more savings
4. Some devices or players will be unable to play specific formats ---
5. If you use a self-hosted streaming service, your host will have to transcode videos on the fly when a device doesn't </div>
support the original format/resolution leading to choppy playback, transcoding your library ahead of time can avoid this
in most cases ## Table of Contents
- [Transmute](#top)
> Why should I use this over __________? - [About](#about)
- [Built With](#built-with)
Transmute's goal is to make the transcoding process as fast & simple as possible. Most transcoders provide hundreds of - [Setup](#setup)
settings requiring some expertise to properly setup. With Transmute you simply specify what your video files should look - [Production](#production)
like & it will transcode your videos as lossless-ly as possible using multiple computers to make short work of large - [Development](#development)
libraries. - [License](#license)
> How does it work? ## About
After choosing your desired settings & creating a new library in the WebUI, the server will begin scanning videos to ![Placeholder Screenshot](./docs/images/screenshot.png)
collect metadata. If this metadata doesn't match your settings or a healthcheck is required, the server will queue a job.
Transmute provides a simple web based tool to manage your video library. Transmute will watch a directory and automatically
Once a worker is available, it will request a job from the server & complete it using FFmpeg. transcode videos using [FFmpeg](https://ffmpeg.org/) & hardware acceloration (if available) so that your entire library
meets a specified standard. In addition to transcoding, Transmute can also remove undesired audio tracks, subtitles,
## Documentation perform healthchecks & upscale/downscale video.
- [Wiki Docs](https://gitlab.zakscode.com/zakscode/transmute/transmute/-/wikis/home)
- [Release Notes](https://gitlab.zakscode.com/zakscode/transmute/transmute/-/releases) ---
- [Tickets & Issues](https://gitlab.zakscode.com/zakscode/transmute/transmute/-/issues)
> Why do I care?
## Setup
<details> 1. Transcoding `MPEG-2/MPEG-4` video to `h.264/h.265` can reduce file size by **50-90%**
<summary> 2. A more extreme measure is downscaling `4K` to `1080p` to reduce size by a further **75%**
<h3 style="display: inline">Production</h3> 3. Stripping out unused audio tracks & subtitles can result in more savings
</summary> 4. Some devices or players will be unable to play specific formats
5. If you use a self-hosted streaming service, your host will have to transcode videos on the fly when a device doesn't
#### Prerequisites support the original format/resolution leading to choppy playback, transcoding your library ahead of time can avoid this
- [Docker](https://www.docker.com/products/docker-desktop/) in most cases
#### Instructions > Why should I use this over __________?
1. Download the [example compose file](https://gitlab.zakscode.com/zakscode/transmute/transmute/-/blob/main/docker-compose.yml) on your server: `curl -o transmute.yml https://gitlab.zakscode.com/zakscode/transmute/transmute/-/raw/main/docker-compose.yml`
2. Read the [Configuration Guide](https://gitlab.zakscode.com/zakscode/transmute/transmute/-/wikis/home) & edit the compose file accordingly Transmute's goal is to make the transcoding process as fast & simple as possible. Most transcoders provide hundreds of
3. Run the compose file: settings requiring some expertise to properly setup. With Transmute you simply specify what your video files should look
- Using Docker Compose: `docker compose -f transmute.yml up` like & it will transcode your videos as lossless-ly as possible using multiple computers to make short work of large
- Using Docker Swarm: `docker stack deploy transmute -c transmute.yml` libraries.
</details> > How does it work?
<details> After choosing your desired settings & creating a new library in the WebUI, the server will begin scanning videos to
<summary> collect metadata. If this metadata doesn't match your settings or a healthcheck is required, the server will queue a job.
<h3 style="display: inline">Development</h3>
</summary> Once a worker is available, it will request a job from the server & complete it using FFmpeg.
#### Prerequisites ### Built With
- [Git](https://git-scm.com/downloads) [![Angular](https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular)](https://angular.io/)
- [Node](https://nodejs.org/en/download) [![Bootstrap](https://img.shields.io/badge/Bootstrap-563D7C?style=for-the-badge&logo=bootstrap&logoColor=white)](https://getbootstrap.com)
- [FFmpeg](https://ffmpeg.org/download.html) [![Docker](https://img.shields.io/badge/Docker-384d54?style=for-the-badge&logo=docker)](https://docker.com/)
- *[Docker](https://www.docker.com/products/docker-desktop/) (Optional)* [![Node](https://img.shields.io/badge/Node.js-000000?style=for-the-badge&logo=nodedotjs)](https://nodejs.org/)
[![Shell](https://img.shields.io/badge/Shell-000000?style=for-the-badge&logo=windowsterminal&logoColor=00ff00)](https://en.wikipedia.org/wiki/Shell_script)
#### Instructions [![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://typescriptlang.org/)
1. Clone this project: `git clone `
2. Pull the submodules: `git submodule update --remote --init` ## Setup
3. Checkout the latest: `git submodule foreach git switch develop`
4. Install dependencies: `git submodule foreach npm i` <details>
5. Link common: <summary>
1. Link common to npm: `cd common && npm link` <h3 style="display: inline">Production</h3>
2. Link common to client (re-run after every `npm install`): `cd ../client && npm link @transmute/common` </summary>
3. Link common to server (re-run after every `npm install`): `cd ../server && npm link @transmute/common`
4. Link common to worker (re-run after every `npm install`): `cd ../worker && npm link @transmute/common` #### Prerequisites
6. Start each project as needed: - [Docker](https://www.docker.com/products/docker-desktop/)
- Start common: `cd ../common && npm run watch`
- Start client: `cd ../client && npm run start` #### Instructions
- Start server: `cd ../server && npm run start` 1. Download the [example compose file](https://gitlab.zakscode.com/zakscode/transmute/transmute/-/blob/main/docker-compose.yml) on your server: `curl -o transmute.yml https://gitlab.zakscode.com/zakscode/transmute/transmute/-/raw/main/docker-compose.yml`
- Start worker: `cd ../worker && npm run start` 2. Read the [Configuration Guide](https://gitlab.zakscode.com/zakscode/transmute/transmute/-/wikis/home) & edit the compose file accordingly
3. Run the compose file:
</details> - Using Docker Compose: `docker compose -f transmute.yml up`
- Using Docker Swarm: `docker stack deploy transmute -c transmute.yml`
</details>
<details>
<summary>
<h3 style="display: inline">Development</h3>
</summary>
#### Prerequisites
- [Git](https://git-scm.com/downloads)
- [Node](https://nodejs.org/en/download)
- [FFmpeg](https://ffmpeg.org/download.html)
- [Docker](https://www.docker.com/products/docker-desktop/)
#### Instructions
1. Clone this project: `git clone `
2. Pull the submodules: `git submodule update --remote --init`
3. Checkout the latest: `git submodule foreach git switch develop`
4. Install dependencies: `git submodule foreach npm i`
5. Link common:
1. Link common to npm: `cd common && npm link`
2. Link common to client (re-run after every `npm install`): `cd ../client && npm link @transmute/common`
3. Link common to server (re-run after every `npm install`): `cd ../server && npm link @transmute/common`
4. Link common to worker (re-run after every `npm install`): `cd ../worker && npm link @transmute/common`
6. Start each project as needed:
- Start common: `cd ../common && npm run watch`
- Start client: `cd ../client && npm run start`
- Start server: `cd ../server && npm run start`
- Start worker: `cd ../worker && npm run start`
</details>
## License
Copyright © 2023 Zakary Timson | Available under MIT Licensing
See the [license](./LICENSE) for more information.