pyvideotools 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. pyvideotools-0.1.0/LICENSE +9 -0
  2. pyvideotools-0.1.0/PKG-INFO +102 -0
  3. pyvideotools-0.1.0/README.md +81 -0
  4. pyvideotools-0.1.0/pyproject.toml +24 -0
  5. pyvideotools-0.1.0/pyvideotools.egg-info/PKG-INFO +102 -0
  6. pyvideotools-0.1.0/pyvideotools.egg-info/SOURCES.txt +9 -0
  7. pyvideotools-0.1.0/pyvideotools.egg-info/dependency_links.txt +1 -0
  8. pyvideotools-0.1.0/pyvideotools.egg-info/requires.txt +2 -0
  9. pyvideotools-0.1.0/pyvideotools.egg-info/top_level.txt +1 -0
  10. pyvideotools-0.1.0/setup.cfg +4 -0
  11. pyvideotools-0.1.0/setup.py +13 -0
pyvideotools-0.1.0/LICENSE ADDED
@@ -0,0 +1,9 @@
1
+ MIT License
2
+
3
+ Copyright 2026 Noam Hache noam.hache@gmail.com
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
6
+
7
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
8
+
9
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
pyvideotools-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,102 @@
1
+ Metadata-Version: 2.4
2
+ Name: pyvideotools
3
+ Version: 0.1.0
4
+ Summary: Video metric and encoding tools
5
+ Home-page: https://github.com/Noam-Hache/pyvideotools
6
+ Author: Noam Hache
7
+ Author-email: Noam Hache <noam.hache@gmail.com>
8
+ License-Expression: MIT
9
+ Project-URL: Homepage, https://github.com/Noam-Hache/pyvideotools
10
+ Project-URL: Issues, https://github.com/Noam-Hache/pyvideotools/issues
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Operating System :: OS Independent
13
+ Requires-Python: >=3.13
14
+ Description-Content-Type: text/markdown
15
+ License-File: LICENSE
16
+ Requires-Dist: setuptools>=84.0.0
17
+ Requires-Dist: vsjetpack[source]>=2.2.4
18
+ Dynamic: author
19
+ Dynamic: home-page
20
+ Dynamic: license-file
21
+
22
+ # pyvideotools : Quality Metrics & Video Encoding
23
+
24
+ WIP
25
+
26
+ Python utilities for video quality measurement and video encoding using VapourSynth.
27
+
28
+ Simple metric usage with statistics.
29
+ x264 and SVT-AV1 bindings.
30
+
31
+ ## Features
32
+ - Quality metrics
33
+ - SSIMULACRA2
34
+ - XPSNR
35
+ - Butteraugli
36
+ - CVVDP
37
+ - CPU and GPU implementations
38
+ - x264 and SVT-AV1 encoding (WIP)
39
+
40
+ ## Requirements
41
+
42
+ - Python
43
+ - [VapourSynth](https://www.vapoursynth.com/)
44
+ - [L-SMASH Works](https://github.com/HomeOfAviSynthPlusEvolution/L-SMASH-Works)
45
+ - [VS-ZIP](https://github.com/dnjulek/vapoursynth-zip) and/or [VSHIP](https://codeberg.org/Line-fr/Vship)
46
+ - [FFmpeg](https://ffmpeg.org/), [x264](https://www.videolan.org/developers/x264.html), [SVT-AV1](https://gitlab.com/AOMediaCodec/SVT-AV1), or [Turbo-Metrics](https://github.com/Gui-Yom/turbo-metrics) depending on the features used
47
+
48
+ ## Examples
49
+ ### Quality metrics examples
50
+
51
+ ```python
52
+ from src.pyvideotools import metrics
53
+ from pathlib import Path
54
+
55
+ metric = metrics.VSzipSSIMULACRA2(
56
+ source=Path("source.mkv"),
57
+ distorted=Path("encoded.mkv"),
58
+ skip=3,
59
+ )
60
+
61
+ metric.run()
62
+
63
+ print(metric.scores_standard_deviation)
64
+ print(metric.scores_median)
65
+ ```
66
+
67
+ ### Encoding examples
68
+
69
+ SVT-AV1 CRF Encoding
70
+ ```python
71
+ from src.pyvideotools import encoders
72
+
73
+ cmd = encoders.SVTAV1CommandBuilder()
74
+ cmd.input("input.mkv")
75
+ cmd.preset("4")
76
+ cmd.crf(30)
77
+ cmd.output("output.mkv", overwrite=True)
78
+ cmd.run()
79
+ ```
80
+
81
+ x264 2-pass target bitrate
82
+ ```python
83
+ from src.pyvideotools import encoders
84
+
85
+ cmd = encoders.x264CommandBuilder()
86
+ cmd.input("input.mkv")
87
+ cmd.preset("faster")
88
+ cmd.bitrate(682)
89
+ cmd.passes(2)
90
+ cmd.output("output.mkv", overwrite=True)
91
+ cmd.run()
92
+ ```
93
+
94
+
95
+ ## Supported Implementations
96
+
97
+ | Metric | CPU | GPU |
98
+ | ----------- | ---------------------- | ----- |
99
+ | SSIMULACRA2 | VS-ZIP / Turbo-Metrics | VSHIP |
100
+ | XPSNR | VS-ZIP / FFmpeg | - |
101
+ | Butteraugli | - | VSHIP |
102
+ | CVVDP | - | VSHIP |
pyvideotools-0.1.0/README.md ADDED
@@ -0,0 +1,81 @@
1
+ # pyvideotools : Quality Metrics & Video Encoding
2
+
3
+ WIP
4
+
5
+ Python utilities for video quality measurement and video encoding using VapourSynth.
6
+
7
+ Simple metric usage with statistics.
8
+ x264 and SVT-AV1 bindings.
9
+
10
+ ## Features
11
+ - Quality metrics
12
+ - SSIMULACRA2
13
+ - XPSNR
14
+ - Butteraugli
15
+ - CVVDP
16
+ - CPU and GPU implementations
17
+ - x264 and SVT-AV1 encoding (WIP)
18
+
19
+ ## Requirements
20
+
21
+ - Python
22
+ - [VapourSynth](https://www.vapoursynth.com/)
23
+ - [L-SMASH Works](https://github.com/HomeOfAviSynthPlusEvolution/L-SMASH-Works)
24
+ - [VS-ZIP](https://github.com/dnjulek/vapoursynth-zip) and/or [VSHIP](https://codeberg.org/Line-fr/Vship)
25
+ - [FFmpeg](https://ffmpeg.org/), [x264](https://www.videolan.org/developers/x264.html), [SVT-AV1](https://gitlab.com/AOMediaCodec/SVT-AV1), or [Turbo-Metrics](https://github.com/Gui-Yom/turbo-metrics) depending on the features used
26
+
27
+ ## Examples
28
+ ### Quality metrics examples
29
+
30
+ ```python
31
+ from src.pyvideotools import metrics
32
+ from pathlib import Path
33
+
34
+ metric = metrics.VSzipSSIMULACRA2(
35
+ source=Path("source.mkv"),
36
+ distorted=Path("encoded.mkv"),
37
+ skip=3,
38
+ )
39
+
40
+ metric.run()
41
+
42
+ print(metric.scores_standard_deviation)
43
+ print(metric.scores_median)
44
+ ```
45
+
46
+ ### Encoding examples
47
+
48
+ SVT-AV1 CRF Encoding
49
+ ```python
50
+ from src.pyvideotools import encoders
51
+
52
+ cmd = encoders.SVTAV1CommandBuilder()
53
+ cmd.input("input.mkv")
54
+ cmd.preset("4")
55
+ cmd.crf(30)
56
+ cmd.output("output.mkv", overwrite=True)
57
+ cmd.run()
58
+ ```
59
+
60
+ x264 2-pass target bitrate
61
+ ```python
62
+ from src.pyvideotools import encoders
63
+
64
+ cmd = encoders.x264CommandBuilder()
65
+ cmd.input("input.mkv")
66
+ cmd.preset("faster")
67
+ cmd.bitrate(682)
68
+ cmd.passes(2)
69
+ cmd.output("output.mkv", overwrite=True)
70
+ cmd.run()
71
+ ```
72
+
73
+
74
+ ## Supported Implementations
75
+
76
+ | Metric | CPU | GPU |
77
+ | ----------- | ---------------------- | ----- |
78
+ | SSIMULACRA2 | VS-ZIP / Turbo-Metrics | VSHIP |
79
+ | XPSNR | VS-ZIP / FFmpeg | - |
80
+ | Butteraugli | - | VSHIP |
81
+ | CVVDP | - | VSHIP |
pyvideotools-0.1.0/pyproject.toml ADDED
@@ -0,0 +1,24 @@
1
+ [project]
2
+ name = "pyvideotools"
3
+ version = "0.1.0"
4
+ description = "Video metric and encoding tools"
5
+ readme = "README.md"
6
+ requires-python = ">=3.13"
7
+ dependencies = [
8
+ "setuptools>=84.0.0",
9
+ "vsjetpack[source]>=2.2.4",
10
+ ]
11
+ authors = [
12
+ { name="Noam Hache", email="noam.hache@gmail.com" },
13
+ ]
14
+
15
+ classifiers = [
16
+ "Programming Language :: Python :: 3",
17
+ "Operating System :: OS Independent",
18
+ ]
19
+ license = "MIT"
20
+ license-files = ["LICEN[CS]E*"]
21
+
22
+ [project.urls]
23
+ Homepage = "https://github.com/Noam-Hache/pyvideotools"
24
+ Issues = "https://github.com/Noam-Hache/pyvideotools/issues"
pyvideotools-0.1.0/pyvideotools.egg-info/PKG-INFO ADDED
@@ -0,0 +1,102 @@
1
+ Metadata-Version: 2.4
2
+ Name: pyvideotools
3
+ Version: 0.1.0
4
+ Summary: Video metric and encoding tools
5
+ Home-page: https://github.com/Noam-Hache/pyvideotools
6
+ Author: Noam Hache
7
+ Author-email: Noam Hache <noam.hache@gmail.com>
8
+ License-Expression: MIT
9
+ Project-URL: Homepage, https://github.com/Noam-Hache/pyvideotools
10
+ Project-URL: Issues, https://github.com/Noam-Hache/pyvideotools/issues
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Operating System :: OS Independent
13
+ Requires-Python: >=3.13
14
+ Description-Content-Type: text/markdown
15
+ License-File: LICENSE
16
+ Requires-Dist: setuptools>=84.0.0
17
+ Requires-Dist: vsjetpack[source]>=2.2.4
18
+ Dynamic: author
19
+ Dynamic: home-page
20
+ Dynamic: license-file
21
+
22
+ # pyvideotools : Quality Metrics & Video Encoding
23
+
24
+ WIP
25
+
26
+ Python utilities for video quality measurement and video encoding using VapourSynth.
27
+
28
+ Simple metric usage with statistics.
29
+ x264 and SVT-AV1 bindings.
30
+
31
+ ## Features
32
+ - Quality metrics
33
+ - SSIMULACRA2
34
+ - XPSNR
35
+ - Butteraugli
36
+ - CVVDP
37
+ - CPU and GPU implementations
38
+ - x264 and SVT-AV1 encoding (WIP)
39
+
40
+ ## Requirements
41
+
42
+ - Python
43
+ - [VapourSynth](https://www.vapoursynth.com/)
44
+ - [L-SMASH Works](https://github.com/HomeOfAviSynthPlusEvolution/L-SMASH-Works)
45
+ - [VS-ZIP](https://github.com/dnjulek/vapoursynth-zip) and/or [VSHIP](https://codeberg.org/Line-fr/Vship)
46
+ - [FFmpeg](https://ffmpeg.org/), [x264](https://www.videolan.org/developers/x264.html), [SVT-AV1](https://gitlab.com/AOMediaCodec/SVT-AV1), or [Turbo-Metrics](https://github.com/Gui-Yom/turbo-metrics) depending on the features used
47
+
48
+ ## Examples
49
+ ### Quality metrics examples
50
+
51
+ ```python
52
+ from src.pyvideotools import metrics
53
+ from pathlib import Path
54
+
55
+ metric = metrics.VSzipSSIMULACRA2(
56
+ source=Path("source.mkv"),
57
+ distorted=Path("encoded.mkv"),
58
+ skip=3,
59
+ )
60
+
61
+ metric.run()
62
+
63
+ print(metric.scores_standard_deviation)
64
+ print(metric.scores_median)
65
+ ```
66
+
67
+ ### Encoding examples
68
+
69
+ SVT-AV1 CRF Encoding
70
+ ```python
71
+ from src.pyvideotools import encoders
72
+
73
+ cmd = encoders.SVTAV1CommandBuilder()
74
+ cmd.input("input.mkv")
75
+ cmd.preset("4")
76
+ cmd.crf(30)
77
+ cmd.output("output.mkv", overwrite=True)
78
+ cmd.run()
79
+ ```
80
+
81
+ x264 2-pass target bitrate
82
+ ```python
83
+ from src.pyvideotools import encoders
84
+
85
+ cmd = encoders.x264CommandBuilder()
86
+ cmd.input("input.mkv")
87
+ cmd.preset("faster")
88
+ cmd.bitrate(682)
89
+ cmd.passes(2)
90
+ cmd.output("output.mkv", overwrite=True)
91
+ cmd.run()
92
+ ```
93
+
94
+
95
+ ## Supported Implementations
96
+
97
+ | Metric | CPU | GPU |
98
+ | ----------- | ---------------------- | ----- |
99
+ | SSIMULACRA2 | VS-ZIP / Turbo-Metrics | VSHIP |
100
+ | XPSNR | VS-ZIP / FFmpeg | - |
101
+ | Butteraugli | - | VSHIP |
102
+ | CVVDP | - | VSHIP |
pyvideotools-0.1.0/pyvideotools.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,9 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ setup.py
5
+ pyvideotools.egg-info/PKG-INFO
6
+ pyvideotools.egg-info/SOURCES.txt
7
+ pyvideotools.egg-info/dependency_links.txt
8
+ pyvideotools.egg-info/requires.txt
9
+ pyvideotools.egg-info/top_level.txt
pyvideotools-0.1.0/pyvideotools.egg-info/requires.txt ADDED
@@ -0,0 +1,2 @@
1
+ setuptools>=84.0.0
2
+ vsjetpack[source]>=2.2.4
pyvideotools-0.1.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
pyvideotools-0.1.0/setup.py ADDED
@@ -0,0 +1,13 @@
1
+ from setuptools import setup, find_packages
2
+
3
+ setup(
4
+ name="pyvideotools",
5
+ version="0.1.0",
6
+ packages=find_packages(),
7
+ install_requires=[],
8
+ author="Noam Hache",
9
+ description="Video metric and encoding tools",
10
+ # long_description=open("./readme.md").read(),
11
+ long_description_content_type="text/markdown",
12
+ url="https://github.com/Noam-Hache/pyvideotools",
13
+ )