Skip to content

Commit be3bd72

Browse files
TrinitouTrinitou
committed
add files
1 parent a8c2462 commit be3bd72

7 files changed

+189
-0
lines changed

‎.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
target

‎Readme.md

+23
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Video playback for Bitwig Studio using xjadeo.
2+
3+
A lightweight solution for video playback with [Bitwig Studio](https://www.bitwig.com/de/overview/) using [xjadeo](https://xjadeo.sourceforge.net). A video file can be added per Bitwig project which then will be played back in sync with Bitwig's transport. Also the video will be saved and opened together with the project automatically.
4+
5+
The implementation makes use of xjadeo's OSC remote control capabilities which are documented [here](https://xjadeo.sourceforge.net/osc.html).
6+
7+
## Setup
8+
9+
1. Put the .js into the Bitwig controller script folder
10+
2. Add the controller script in Bitwig Studio
11+
- via *Dashboard -> 'Settings' -> 'Controllers' -> '+ Add Controller'*
12+
- select hardware vendor: 'xjadeo'
13+
- select product: 'xJadeo Video Sync'
14+
- click *'Add'*
15+
3. Click the "?" icon and follow the setup instructions in the help HTML
16+
17+
## Build
18+
19+
Nothing to build for the controller script, but the help documentation HTML is generated from the [help.md](./doc/help.md) using the [generate_HTML.ps1](./doc/generate_HTML.ps1) script which requires Powershell 7 to work.
20+
21+
## Contribution
22+
23+
Please feel free to create a pull request if you want to add or change something! Also have a look into open issues if you want so.

‎doc/help.css

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
html {
2+
font: 14px "Lucida Grande", Lucida, Verdana, sans-serif;
3+
}

‎doc/help.md

+31
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
<head>
2+
<title class="title">xjadeo Video Sync</title>
3+
<style type="text/css" media="all">@import "./doc/help.css";</style>
4+
</head>
5+
6+
# xJadeo Video Synchronization
7+
8+
## Setup
9+
10+
- **Download and install xjadeo**, e.g. from [here](https://xjadeo.sourceforge.net/download.html)
11+
- **Launch the *'launch xJadeo.bat'* script**. This opens the xjadeo window.
12+
- In Bitwig Studio, connect the video file for playback like this:
13+
- Open a project.
14+
- In the *Studio I/O panel*, unfold the *xJadeo Video Sync* settings.
15+
- Enter the absolute video file path under *Path*.
16+
- Enter the original frame rate of the video under 'Frame rate'.
17+
18+
## Features
19+
- If you save the project and open it later, the video will be opened again together with the project.
20+
- You can easily switch Bitwig project tabs with different videos and the xJadeo window will be udpated on the fly!
21+
- There is a *'Keep on top'* checkbox which will ensure that the video window stays in front of Bitwig Studio. (default: on)
22+
- The *'Flush!'* button in the settings will (re-)send all data to the xJadeo window. This is helpful if xJadeo was opened after Bitwig Studio.
23+
24+
## Tipps & tricks
25+
26+
- 'Where to quickly find original video frame?'
27+
- When using the *'launch xJadeo.bat'* script, a console window will open as well. Look into the log text!
28+
- How to hear the original sound of the video file in sync with the video?
29+
- If Bitwig supports the file format, you can drag it into the project so that.
30+
- Place it into the Arranger at position 1.1.1.00
31+
- Make sure that time-stretching is off for that audio clip (*Mode* set to *'Raw'*)

‎generate_release.ps1

+28
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
$version = "0.1"
2+
3+
$targetTempDir = ".\target\tmp"
4+
New-Item -ItemType Directory -Force -Path $targetTempDir
5+
6+
$docSourceDir = ".\doc"
7+
$md = ConvertFrom-Markdown -Path "$docSourceDir\help.md"
8+
if($md) {
9+
$md.Html | Out-File -Encoding utf8 "$targetTempDir\xJadeo Video Sync.html"
10+
$helpCssFileName = "help.css"
11+
$cssTargetDir = "$targetTempDir\doc"
12+
New-Item -ItemType Directory -Force -Path "$cssTargetDir"
13+
Copy-Item -Path "$docSourceDir\$helpCssFileName" -Destination "$cssTargetDir\$helpCssFileName"
14+
}
15+
16+
$sourceDir = ".\src"
17+
$controlScriptPath = "xJadeo Video Sync.control.js"
18+
Copy-Item -Path "$sourceDir\$controlScriptPath" -Destination "$targetTempDir\$controlScriptPath"
19+
$launchScriptPath = "launch xjadeo.bat"
20+
Copy-Item -Path "$sourceDir\$launchScriptPath" -Destination "$targetTempDir\$launchScriptPath"
21+
22+
$targetZipPath = "$PSScriptRoot\target\xJadeo_Video_Sync_" + ($version -replace '\.', '_') + ".zip"
23+
$compress = @{
24+
Path = "$targetTempDir\*"
25+
CompressionLevel = "Fastest"
26+
DestinationPath = $targetZipPath
27+
}
28+
Compress-Archive @compress -Force

‎src/launch xjadeo.bat

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
"C:\Program Files\xjadeo\xjadeo.exe" -O 12345

‎src/xJadeo Video Sync.control.js

+102
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
loadAPI(17);
2+
3+
host.setShouldFailOnDeprecatedUse(true);
4+
5+
host.defineController("xjadeo", "xJadeo Video Sync", "0.1", "295c10cb-b8d6-416b-9be5-dc2375936ac0", "Trinitou");
6+
7+
var oscConnection;
8+
9+
var lastOnTopState;
10+
function invalidateLastOnTopState() {
11+
lastOnTopState = null;
12+
}
13+
function updateOnTop(onTop) {
14+
if(onTop == lastOnTopState)
15+
return;
16+
oscConnection.sendMessage("/jadeo/cmd", "window ontop " + (onTop ? "on" : "off"));
17+
lastOnTopState = onTop;
18+
host.println("Sent 'Keep on top' state: " + (onTop ? "on" : "off"));
19+
}
20+
21+
var lastVideoPath;
22+
function invalidateLastVideoPath() {
23+
lastVideoPath = null;
24+
}
25+
function updateVideo(path) {
26+
if (path === lastVideoPath)
27+
return false;
28+
oscConnection.sendMessage("/jadeo/load", path); // sending an empty path will close current video file
29+
host.println("Sent video path: '" + path + "'");
30+
lastVideoPath = path;
31+
return true;
32+
}
33+
34+
var lastFrame;
35+
function invalidateLastFrame() {
36+
lastFrame = -1;
37+
}
38+
function updateFrame(frame) {
39+
if (oscConnection == null) {
40+
invalidateLastFrame();
41+
return;
42+
}
43+
if (frame != lastFrame) {
44+
oscConnection.sendMessage("/jadeo/seek", frame);
45+
lastFrame = frame;
46+
// host.println("Sent frame: " + lastFrame);
47+
}
48+
}
49+
50+
function invalidateAll() {
51+
invalidateLastOnTopState();
52+
invalidateLastVideoPath();
53+
invalidateLastFrame();
54+
}
55+
56+
var onTopSetting;
57+
var pathSetting;
58+
var frameRateSetting;
59+
var pos;
60+
61+
function init() {
62+
oscConnection = host.getOscModule().connectToUdpServer("localhost", 12345, null);
63+
64+
let prefs = host.getPreferences();
65+
66+
onTopSetting = prefs.getBooleanSetting("Keep on top", "Video window", true);
67+
onTopSetting.markInterested();
68+
69+
let docState = host.getDocumentState();
70+
71+
pathSetting = docState.getStringSetting("Path", "File", 256, "");
72+
pathSetting.markInterested();
73+
74+
frameRateSetting = docState.getNumberSetting("FPS", "File", 24, 60, 0.01, "", 24);
75+
frameRateSetting.markInterested();
76+
77+
// add flush command to both the preferences and document state for easy access:
78+
let settings = [prefs, docState];
79+
for(var i = 0; i < settings.length; i++) {
80+
settings[i].getSignalSetting("Flush", "Video window", "Flush!").addSignalObserver(function () {
81+
invalidateAll();
82+
});
83+
}
84+
85+
pos = host.createTransport().playPositionInSeconds();
86+
pos.markInterested();
87+
88+
invalidateAll();
89+
90+
println("xJadeo Connect initialized!");
91+
}
92+
93+
function flush() {
94+
updateOnTop(onTopSetting.get());
95+
if (updateVideo(pathSetting.get()))
96+
invalidateLastFrame();
97+
updateFrame(Math.floor(pos.get() * frameRateSetting.getRaw()));
98+
}
99+
100+
function exit() {
101+
updateVideo("");
102+
}

0 commit comments

Comments
 (0)