djhud 0.7.3__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 (12) hide show
  1. djhud-0.7.3/LICENSE +21 -0
  2. djhud-0.7.3/PKG-INFO +113 -0
  3. djhud-0.7.3/README.md +71 -0
  4. djhud-0.7.3/pyproject.toml +71 -0
  5. djhud-0.7.3/src/djhud/__init__.py +4 -0
  6. djhud-0.7.3/src/djhud/__main__.py +18 -0
  7. djhud-0.7.3/src/djhud/app.py +1235 -0
  8. djhud-0.7.3/src/djhud/diagnostics.py +214 -0
  9. djhud-0.7.3/src/djhud/models.py +94 -0
  10. djhud-0.7.3/src/djhud/platform.py +333 -0
  11. djhud-0.7.3/src/djhud/widgets.py +656 -0
  12. djhud-0.7.3/tests/test_basic.py +59 -0
djhud-0.7.3/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024-2025 DJ HUD Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
djhud-0.7.3/PKG-INFO ADDED
@@ -0,0 +1,113 @@
1
+ Metadata-Version: 2.4
2
+ Name: djhud
3
+ Version: 0.7.3
4
+ Summary: Lightweight screen/webcam region capture and virtual camera tool for DJs
5
+ Project-URL: Homepage, https://github.com/djhud/djhud
6
+ Project-URL: Issues, https://github.com/djhud/djhud/issues
7
+ Author: DJ HUD Contributors
8
+ License-Expression: MIT
9
+ License-File: LICENSE
10
+ Keywords: dj,hud,obs,rekordbox,screen-capture,serato,streaming,traktor,vdo-ninja,virtual-camera,webcam
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: End Users/Desktop
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Operating System :: MacOS
15
+ Classifier: Operating System :: Microsoft :: Windows
16
+ Classifier: Operating System :: POSIX :: Linux
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.9
19
+ Classifier: Programming Language :: Python :: 3.10
20
+ Classifier: Programming Language :: Python :: 3.11
21
+ Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Programming Language :: Python :: 3.13
23
+ Classifier: Topic :: Multimedia :: Sound/Audio
24
+ Classifier: Topic :: Multimedia :: Video
25
+ Requires-Python: >=3.9
26
+ Requires-Dist: mss>=7.0
27
+ Requires-Dist: numpy>=1.21
28
+ Requires-Dist: opencv-python>=4.5
29
+ Requires-Dist: pillow>=9.0
30
+ Provides-Extra: all
31
+ Requires-Dist: pyobjc-framework-quartz>=9.0; (sys_platform == 'darwin') and extra == 'all'
32
+ Requires-Dist: pyvirtualcam>=0.3; extra == 'all'
33
+ Provides-Extra: dev
34
+ Requires-Dist: build; extra == 'dev'
35
+ Requires-Dist: pytest>=7.0; extra == 'dev'
36
+ Requires-Dist: twine; extra == 'dev'
37
+ Provides-Extra: mac
38
+ Requires-Dist: pyobjc-framework-quartz>=9.0; extra == 'mac'
39
+ Provides-Extra: virtualcam
40
+ Requires-Dist: pyvirtualcam>=0.3; extra == 'virtualcam'
41
+ Description-Content-Type: text/markdown
42
+
43
+ # DJ HUD
44
+
45
+ Lightweight screen/webcam region capture and virtual camera tool for DJs.
46
+
47
+ Capture BPM, track info, waveforms, and deck status from your DJ software and stream it to remote DJs via VDO.Ninja, OBS, Discord, or Zoom.
48
+
49
+ ## Install
50
+
51
+ ```bash
52
+ pip install djhud
53
+ ```
54
+
55
+ ### Optional extras
56
+
57
+ ```bash
58
+ # Virtual camera output (requires OBS Virtual Camera driver on Windows)
59
+ pip install djhud[virtualcam]
60
+
61
+ # macOS window listing support
62
+ pip install djhud[mac]
63
+
64
+ # Everything
65
+ pip install djhud[all]
66
+ ```
67
+
68
+ ## Run
69
+
70
+ ```bash
71
+ djhud
72
+ ```
73
+
74
+ Or as a Python module:
75
+
76
+ ```bash
77
+ python -m djhud
78
+ ```
79
+
80
+ ## Features
81
+
82
+ - **Region capture** — select parts of any monitor, window, or webcam
83
+ - **Region editor** — drag, resize, crop, scale, lock aspect ratio, snap to grid, pixel nudge
84
+ - **Canvas compositor** — combine multiple regions into a single output
85
+ - **Webcam input** — device selection, resolution, FPS, flip, rotate, brightness, contrast, freeze/snapshot
86
+ - **Virtual camera output** — via pyvirtualcam → OBS Virtual Camera → VDO.Ninja / Discord / Zoom
87
+ - **Presets** — save/load JSON layouts per DJ app
88
+ - **System diagnostics** — dependency check, capability check, export report
89
+ - **Cross-platform** — Windows (full), macOS (screen + webcam), Linux (screen + webcam)
90
+
91
+ ## Use case
92
+
93
+ Remote DJ back-to-back streaming. Capture BPM, track, key, waveform, and deck status from Traktor / Rekordbox / Serato / VirtualDJ / Djay and stream to your remote DJ partner.
94
+
95
+ ## Supported DJ software
96
+
97
+ Works with any DJ software by capturing screen regions. Preset templates planned for:
98
+
99
+ - Traktor Pro
100
+ - Rekordbox
101
+ - Serato DJ
102
+ - VirtualDJ
103
+ - Djay Pro
104
+
105
+ ## Requirements
106
+
107
+ - Python 3.9+
108
+ - Windows 10/11, macOS, or Linux
109
+ - For virtual camera: OBS Virtual Camera driver (Windows) or OBS (Mac/Linux)
110
+
111
+ ## License
112
+
113
+ MIT
djhud-0.7.3/README.md ADDED
@@ -0,0 +1,71 @@
1
+ # DJ HUD
2
+
3
+ Lightweight screen/webcam region capture and virtual camera tool for DJs.
4
+
5
+ Capture BPM, track info, waveforms, and deck status from your DJ software and stream it to remote DJs via VDO.Ninja, OBS, Discord, or Zoom.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ pip install djhud
11
+ ```
12
+
13
+ ### Optional extras
14
+
15
+ ```bash
16
+ # Virtual camera output (requires OBS Virtual Camera driver on Windows)
17
+ pip install djhud[virtualcam]
18
+
19
+ # macOS window listing support
20
+ pip install djhud[mac]
21
+
22
+ # Everything
23
+ pip install djhud[all]
24
+ ```
25
+
26
+ ## Run
27
+
28
+ ```bash
29
+ djhud
30
+ ```
31
+
32
+ Or as a Python module:
33
+
34
+ ```bash
35
+ python -m djhud
36
+ ```
37
+
38
+ ## Features
39
+
40
+ - **Region capture** — select parts of any monitor, window, or webcam
41
+ - **Region editor** — drag, resize, crop, scale, lock aspect ratio, snap to grid, pixel nudge
42
+ - **Canvas compositor** — combine multiple regions into a single output
43
+ - **Webcam input** — device selection, resolution, FPS, flip, rotate, brightness, contrast, freeze/snapshot
44
+ - **Virtual camera output** — via pyvirtualcam → OBS Virtual Camera → VDO.Ninja / Discord / Zoom
45
+ - **Presets** — save/load JSON layouts per DJ app
46
+ - **System diagnostics** — dependency check, capability check, export report
47
+ - **Cross-platform** — Windows (full), macOS (screen + webcam), Linux (screen + webcam)
48
+
49
+ ## Use case
50
+
51
+ Remote DJ back-to-back streaming. Capture BPM, track, key, waveform, and deck status from Traktor / Rekordbox / Serato / VirtualDJ / Djay and stream to your remote DJ partner.
52
+
53
+ ## Supported DJ software
54
+
55
+ Works with any DJ software by capturing screen regions. Preset templates planned for:
56
+
57
+ - Traktor Pro
58
+ - Rekordbox
59
+ - Serato DJ
60
+ - VirtualDJ
61
+ - Djay Pro
62
+
63
+ ## Requirements
64
+
65
+ - Python 3.9+
66
+ - Windows 10/11, macOS, or Linux
67
+ - For virtual camera: OBS Virtual Camera driver (Windows) or OBS (Mac/Linux)
68
+
69
+ ## License
70
+
71
+ MIT
djhud-0.7.3/pyproject.toml ADDED
@@ -0,0 +1,71 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "djhud"
7
+ version = "0.7.3"
8
+ description = "Lightweight screen/webcam region capture and virtual camera tool for DJs"
9
+ readme = "README.md"
10
+ license = "MIT"
11
+ requires-python = ">=3.9"
12
+ authors = [
13
+ { name = "DJ HUD Contributors" },
14
+ ]
15
+ keywords = [
16
+ "dj", "hud", "screen-capture", "webcam", "virtual-camera",
17
+ "obs", "vdo-ninja", "streaming", "traktor", "rekordbox", "serato",
18
+ ]
19
+ classifiers = [
20
+ "Development Status :: 4 - Beta",
21
+ "Intended Audience :: End Users/Desktop",
22
+ "License :: OSI Approved :: MIT License",
23
+ "Operating System :: Microsoft :: Windows",
24
+ "Operating System :: MacOS",
25
+ "Operating System :: POSIX :: Linux",
26
+ "Programming Language :: Python :: 3",
27
+ "Programming Language :: Python :: 3.9",
28
+ "Programming Language :: Python :: 3.10",
29
+ "Programming Language :: Python :: 3.11",
30
+ "Programming Language :: Python :: 3.12",
31
+ "Programming Language :: Python :: 3.13",
32
+ "Topic :: Multimedia :: Video",
33
+ "Topic :: Multimedia :: Sound/Audio",
34
+ ]
35
+
36
+ dependencies = [
37
+ "numpy>=1.21",
38
+ "Pillow>=9.0",
39
+ "mss>=7.0",
40
+ "opencv-python>=4.5",
41
+ ]
42
+
43
+ [project.optional-dependencies]
44
+ virtualcam = [
45
+ "pyvirtualcam>=0.3",
46
+ ]
47
+ mac = [
48
+ "pyobjc-framework-Quartz>=9.0",
49
+ ]
50
+ all = [
51
+ "pyvirtualcam>=0.3",
52
+ "pyobjc-framework-Quartz>=9.0; sys_platform == 'darwin'",
53
+ ]
54
+ dev = [
55
+ "pytest>=7.0",
56
+ "build",
57
+ "twine",
58
+ ]
59
+
60
+ [project.urls]
61
+ Homepage = "https://github.com/djhud/djhud"
62
+ Issues = "https://github.com/djhud/djhud/issues"
63
+
64
+ [project.scripts]
65
+ djhud = "djhud.__main__:main"
66
+
67
+ [project.gui-scripts]
68
+ djhud-gui = "djhud.__main__:main"
69
+
70
+ [tool.hatch.build.targets.wheel]
71
+ packages = ["src/djhud"]
djhud-0.7.3/src/djhud/__init__.py ADDED
@@ -0,0 +1,4 @@
1
+ """DJ HUD — Lightweight screen/webcam region capture and virtual camera tool for DJs."""
2
+
3
+ __version__ = "0.7.3"
4
+ APP_NAME = "DJ HUD Builder"
djhud-0.7.3/src/djhud/__main__.py ADDED
@@ -0,0 +1,18 @@
1
+ """Entry point for DJ HUD.
2
+
3
+ Usage:
4
+ djhud # installed via pip
5
+ python -m djhud # run as module
6
+ """
7
+
8
+ import sys
9
+
10
+
11
+ def main():
12
+ """Launch DJ HUD application."""
13
+ from djhud.app import run_app
14
+ run_app()
15
+
16
+
17
+ if __name__ == "__main__":
18
+ main()