VVCEasy/README.md

151 lines
6.6 KiB
Markdown
Raw Normal View History

2021-12-17 04:34:14 +01:00
# VVCEasy (Windows (Full), Mac and Linux (partial)
2022-01-06 03:51:15 +01:00
VVCEasy is that you don't have to compile or/and coding to encode VVC (known as Versatile Video Codec). Simple, Easy, Encode and Decode.
2021-10-20 05:47:19 +02:00
VVCEasy comes to one-easy of ffmpeg, vvenc, vvdec and YUView.
2021-10-20 11:46:13 +02:00
Installation: Go to releases and download latest version.
2021-10-20 12:49:09 +02:00
2021-10-20 13:44:26 +02:00
VVCEasy is not yet finished. I'm trying to work with codes. I'm not good coding programming, just simple coding.
Sorry to say that. I will give update, once I release news.
2021-10-21 08:23:03 +02:00
2021-12-13 14:09:44 +01:00
Windows source run: RUNVVCEASY.bat
2021-10-21 08:23:03 +02:00
2021-12-17 04:34:14 +01:00
Note to Mac and Linux of o266player VLC: Sorry Mac and Linux users :(, on macOS 10.15.6, I tried build, but it failed, you can have a look for Stack Overflow: https://bit.ly/3GTtNTJ
On Linux, it won't support of VLC (o266player build).
If you want to run VLC (o266player version), you have to run Windows only for virtual machine or your real computer.
2022-01-06 03:51:15 +01:00
# Compatability Windows Operating System (VLC Media Player v3.0.11.1, o266player build version)
Windows | Compatibility (only x64)
------- | ------- |
Windows 2000/ME or older | ❌ (Cannot run custom build)
Windows XP | ⚠️ (Terminal only, GUI is not working)
Windows Vista | ⚠️ (GUI Works, but VVC won't work)
Windows 7 | :white_check_mark: (All checked)
Windows 8 | :white_check_mark: (All checked)
Windows 8.1 | :white_check_mark: (All checked)
Windows 10 | :white_check_mark: (All checked)
Windows 11 | :white_check_mark: (All checked)
Windows Server | Check
------- | ------- |
Windows Server 2003 | ⚠️ (Terminal only, GUI is not working)
Windows Server 2008 | ⚠️ (GUI Works, but VVC won't work)
Windows Server 2012 | :white_check_mark: (All checked)
Windows Server 2016 | :white_check_mark: (All checked)
Windows Server 2019 | :white_check_mark: (All checked)
Windows Server 2022 | :white_check_mark: (All checked)
VLC Custom build of o266player only accepts x64 / 64-bit to work. 32-bit / x86 won't work.
This cannot be run on Windows Vista / Windows Server 2008 or older to play VVC of VLC Custom build. Note: I'm trying to work it out of VLC 3.0.16.
2021-12-21 08:22:27 +01:00
2021-10-21 08:23:03 +02:00
# Encode/Decode (easy)
Before you run of RUNVVCEASY.bat or VVCEASY.exe, you need to change input from file name to input.mp4 (as example)
2021-10-21 09:14:44 +02:00
Follow the instructions, the commands will give your options. Since 21 October 2021, VVCEasy is pre-release, but it's construction mode, but you can have a look with .BAT code.
2021-10-21 08:23:03 +02:00
2021-10-20 13:44:26 +02:00
- Martin Eesmaa
2021-10-21 09:10:06 +02:00
2021-10-21 09:13:00 +02:00
# Without VVCEasy, experimental option for professional coders, other developers and everyone (hard)
2021-10-21 09:10:06 +02:00
You need 7Zip (requires ffmpeg and ffplay), ffmpeg, ffplay, vvenc/vvdec(app) and YUView.
Here are the links:
FFMPEG/FFPLAY: https://www.gyan.dev/ffmpeg/builds/ffmpeg-git-full.7z (go to bin folder and extract two files)
VVENC/VVDEC:
https://github.com/MartinEesmaa/VVCEasy/blob/main/VVC/vvencapp.exe
https://github.com/MartinEesmaa/VVCEasy/blob/main/VVC/vvdecapp.exe
YUView:
2021-10-28 12:04:53 +02:00
https://github.com/IENT/YUView/actions/runs/1365560321
2021-10-21 09:10:06 +02:00
2021-10-21 09:19:24 +02:00
Before we start, you need to make path environments for ffmpeg, ffplay and vvenc/vvdec to make easily.
2021-12-14 12:47:16 +01:00
In Command Prompt (Windows):
2021-12-13 06:27:44 +01:00
```
set PATH=%PATH%;C:\Users\blah\Downloads\VVCEasy\Executables
```
2021-12-14 12:47:16 +01:00
Verify using Windows Command Prompt:
```
echo %PATH%
```
2021-10-21 09:19:24 +02:00
2021-10-21 09:10:06 +02:00
First of all:
Transcode any video formats to YUV/Y4M
2021-12-17 05:50:22 +01:00
For YUV transcode:
2021-12-13 06:27:44 +01:00
```
2021-12-17 05:50:22 +01:00
ffmpeg -i input.mp4 -strict 1 inputtranscode.yuv
2021-12-13 06:27:44 +01:00
```
2021-10-21 09:10:06 +02:00
2021-12-17 05:50:22 +01:00
For Y4M transcode:
2021-12-13 06:27:44 +01:00
```
2021-12-17 05:50:22 +01:00
ffmpeg -i input.mp4 -strict 1 inputtranscode.y4m
2021-12-13 06:27:44 +01:00
```
2021-10-21 09:10:06 +02:00
Verify ffplay before encode with VVENC (replace video size, important otherwise it will not show correctly video, it's like scramble eggs):
2021-12-13 06:27:44 +01:00
```
ffplay -f rawvideo -pixel_format yuv420p -video_size 854x480 -i inputtranscode.yuv
```
2021-12-17 05:50:22 +01:00
Or replace -i inputtranscode.yuv with `-i inputtranscode.y4m` for y4m users. For yuv420p10 on your input video 10 bit, replace `-pixel_format yuv420p10`.
For easy to verify YUV/Y4M, use YUView, open your YUV or Y4M encoded, make sure video size, YUV format and frame rate same like from input video file (eg. MP4, AVI, MKV and others.
2021-10-21 09:10:06 +02:00
After verifying correctly
Encode with VVENC (Simple settings, example)
2021-12-13 06:27:44 +01:00
```
vvencapp -i out.yuv -s 854x480 -r 30 -o vvc.266
```
2021-10-21 09:10:06 +02:00
-s means video size, -r means frame per second and -o means output
Note to Apple Mac OS and Linux users: Command with `./vvencapp`
2021-12-14 12:47:16 +01:00
Encode with VVENC (Best settings, replace video size (-s), framerate (-r) and maximize threads of your cores (--threads), example)
2021-12-13 06:27:44 +01:00
```
vvencapp -i out.yuv -s 854x480 -r 30 --preset slow --threads 16 --tier high -o EXTREME.266
```
2021-10-21 09:10:06 +02:00
NOTE: It is acceptable only for encoding to .h266, .266 and .vvc file container.
2021-12-21 08:22:27 +01:00
Note to 10 bit YUV users: If you encoding YUV 10 bit to VVC file, add `-c yuv420_10` before you type ending of -o EXTREME.266
2021-10-28 12:04:53 +02:00
After VVEnc, you can play in YUView develop version, unfortunately this should not work on release version of June.
Drag any your video file of .h266, .266 or .vvc to play. YUView will play your video about only 10 seconds.
2021-10-21 09:10:06 +02:00
2021-12-21 08:22:27 +01:00
UPDATE 13th December 2021: VLC Media Player (custom VLC build of o266player, 3.0.11.1 Vetenari, Windows 11) is tested by Martin Eesmaa. It can play only about 600 frames limit / 20+ seconds.
![VLC Media Player (VVC test)](https://user-images.githubusercontent.com/88035011/145756567-d156f630-9e7f-4042-99b5-6ffe8a6b4b64.png)
2021-10-28 12:04:53 +02:00
If you are still not happy VVC, that you think this is too hard to encode and decode, or this cannot be played on VLC Media Player of VVC Video Codec, use AOMEDIA ONE that is recommended for most users for easily play VLC Media Player and others.
2021-10-21 09:10:06 +02:00
2021-12-13 13:31:19 +01:00
# Compatability results (VVENC AND VVDEC) TEST COMPLETED BY MARTIN EESMAA
2021-12-13 13:31:19 +01:00
Windows (vvencapp):
![WindowsVVENCDEC](https://user-images.githubusercontent.com/88035011/145812753-eddf04c5-1a10-4892-9118-7478735b1475.png)
2021-12-13 13:31:19 +01:00
Mac (./vvencapp):
![MacOSterminal12](https://user-images.githubusercontent.com/88035011/146367066-1fbfcf2a-8e1f-470c-8701-c3ec8c2b9701.png)
2021-12-13 13:31:19 +01:00
Linux (./vvencapp):
![UbuntuVVENCDEC](https://user-images.githubusercontent.com/88035011/145812781-9a270e03-0dc0-47e6-95ad-4316757d3435.png)
2021-12-13 13:31:19 +01:00
2021-11-26 23:53:37 +01:00
# FAQ (known as Frequently Asked Questions)
2021-11-26 23:43:09 +01:00
Are you real creator of VVCEasy?
Yes... but I'm not creator of VVC, I didn't build VVC, so it was Fraunhofer built VVC.
Are you trying to work build of VVCEasy?
Well yeah... it takes longer time to make VVCEasy easier, but VVCEasy is not yet finished until further/update announcement. I don't have employees, so I'm only one.
Is it okay to bring proof screenshots of my errors?
I allow you to bring error screenshots, you can bring proof. More proofs, more easy to solve it.
My question is not listed on FAQ. Can I ask any question?
Sure, just go to Issues tab and ask questions or give it issue to me.
2021-10-21 09:10:06 +02:00
If you have any questions or any issues, please go to Issues tab and create your issue.
- Martin Eesmaa