Guillaume Barrette

ReaScript: Independant Time Offset

Mon, 01 Jan 0001 00:00:00 +0000

About this Script

This Independant Time Offset script lets you move the content of a media item, just like the “Move item contents” action, but while keeping the offset value variation so we can refer to it and revert to no offset easily if wanted and by being able to work on groups or only the selection.

Installation

Manually

Download the file and put it into the folder at: ~/Library/Application Support/REAPER/Scripts/
Open the Reaper's Action list (Actions -> Show action list...) and press the Load.. button next to the ReaScript: label
Locate your file and press the Open button

You can look at this video if you have difficulties to import/load the script

How it works

You can instantiate the script using Reaper's Action list (Actions -> Show action list...) and searching for the Independant Time Offset script in this menu or I would recommend to had a keyboard shortcut to easily and rapidly use the action.

A small window will pop and make the actions work when you click and drag in this window (or by holding the Alt key).

Keyboard Hotkeys:

Key	Action
i	Press “i” to popup the User Input window to manually set the offset value
Ctrl+Alt	Will pop a help menu in a tooltip
Shift	Hold Shift to bypass Groups when doing an action
Secondary Click	Reset offset to 0
Ctrl+Paste	Hold Ctrl while pasting to substract the item offset with the offset value in clipboard
Alt	Hold Alt without click to modify the item offset
Super+LeftClick	Toggle between windowed and docked mode (Super = Cmd key on macOS and Windows key on Windows)

Main View: The Player View

Mon, 01 Jan 0001 00:00:00 +0000

The main view of SyncFrame looks like any traditional video player. However, many little twists where added to make it fast to work with and to keep a workflow that doesn't interfere with your demanding playing situation.

Here we will detail every section of this main view. Please refer you to this top picture to know where every elements are positioned throughout the main view.

Controls

Title Bar (Menus)

Controls	Description
	Access to the Main Preferences of the application
	Modes menu button to switch between the different playing modes (Alone, Auxiliary, Coordinator). It also act as an indicator that shows if your are receiving data from the Coordinator or not (Receiving when Green and Not receiving when White)
	Open the right sidebar where you can have access to your files, projects and configuration (Projects proprieties + Marker List)

Playing Modes

Modes	Description
Alone	Put the device into Alone mode. In this mode, you are in full control of your device; no one on the network will interfere with your solo practice.
Auxiliary	Put the device into Auxiliary mode. In this mode, your device will be controlled by a Coordinator device when one is present on your network.
Coordinator	Put the device in Coordinator mode. In this mode, your device will control the other devices in the network. They will follow your playback position, rate and play/pause states.
(Resync)	When on Auxiliary mode, a Resync button will appear on the left side of this controls group. This button is useful in case a problem occur during a live performance and the Coordinator device gets lost and your device drifted from others. Pressing this button will ask the other devices in the network to send you their position and your device will try to resynchronize to it.
(Force)	When on Coordinator mode, a Force button will appear on the left side of this controls group. This button is useful in case multiple Coordinator device appear on the network and you want to tell them that you are the real main Coordinator. This button will force other into Auxiliary mode.

Top left controls (Visual Modes)

Controls	Description
	Allow to go into fullscreen mode where System User Interface elements (ex: Titlebar) get hidden to reduce even more distracting elements.
	Expand the video frame to fullscreen.
	Go into Presentation Mode where all User Interface elements get hidden and where the playback is activated or paused by a simple tap on the screen and a long press get you out of this mode.

Top right controls (Audio)

Control	Description
	This is the volume control section where we can turn it on or off.

Bottom controls (Playback Controls)

Controls	Description
	Lock/Unlock the controls so you don't accidentally touch them while playing
	Rewind 10 seconds from the current playback position
	Button to Play/Pause the playback
	Forward 10 seconds from the current playback position
	Allow to control the playback rate. (This is only accessible from the Coordinator or Alone mode since on Auxiliary mode the playback rate is controlled by the Coordinator device)
	Time picker to rapidly and precisely go to a specific time position.

Dialogs

Playback Rate

The Playback Rate dialog, accessible by tapping on the button, let you change the speed at which the player play your media file. You can change the value by using the up/down arrow or a drag up/down action on the individual numbers.

Time Picker

This Time Picker dialog, accessible by tapping on the button, let you go rapidly and precisely to a specific time position. It will directly be set to your current position when you open it and you will see the position updated in realtime when changing its values. You can modify the “Hours : Minutes : Seconds . Milliseconds” by clicking on their respective up/down arrows or dragging the numbers up/down to modify them.

Note that the hours won't be shown if the media file doesn't have a length that is equal to an hour or more.

The top right button, the Add Marker button , is a shortcut to add a new marker which will pop the Marker dialog.

Marker

This dialog let you add¹ a marker or let you edit² a previously saved Marker. A description and time position can be set or modified. The same dialog is also used to The controls for the time are the same as with the previous dialog, by using the up/down arrow or the drag up/down action to change the values.

Annotations:
1:	If coming from the Timer Picker dialog or the Add a marker button from the Right Sidebar Markers section.
2:	Accessible by the Edit button from the vertical ellipsis button ( ⋮ ) of a Marker in the Markers list of a project configuration section.

Preferences

Mon, 01 Jan 0001 00:00:00 +0000

The Main Preferences view set the global preferences of the application, meaning those who set the application in a specific state (ex: different language) or set default values for a project file.

To describe the features:

Section	Description
Language	Sets the application in your preferred language based on English or French. It is set to “System” by default which mean that the application will automatically choose between English or French based on how your device is configured, but will fallback to English.
IP Port	Sets the default IP port value to used by default for your project configuration. Therefore, if you don't specify an IP Port to use on your saved project, make sure that this one is set to the same one as the other devices on your network that you want to group together.
Keep Screen Awake	When activated, this prevent your device from going to sleep when using the application.
Show Play/Pause Icon Overlay	When activated, a Play and Pause icon will appear for a short time in the center of the screen on Slave device when a change in the Master playing state occurs.
Show Demo Files	When activated, the Demo section on the Files tab get hidden.

The Reset button at the top right corner of this page can be used to reset those features to their default value.

Right Sidebar: Access Files and Configuration

Mon, 01 Jan 0001 00:00:00 +0000

The right sidebar is where most of the actions related to your files can be found. It is divided into 2 tabs: the first contains the list of your files and projects and the second your project's configuration.

Files Tab

This view is divided into 3 sections:

Section	Description
Demo	This consists simply of a pre-installed list of files used to rapidly test the application when you install it. We recommend to disable this section from the Main Preferences to declutter your list when you don't need it.
Projects	This list consist of your SyncFrame project's files. A project is a container that group you media file with a configuration. Please look at the next section of this documentation to know which data can be set with your configuration.
Media	This list consist of your standard media files that you have imported into the application.

Actions

This view also gives you a serie of actions that can be performed on the Project or Media files. They are accessible by the far right button of each file item.

File	Actions
Project File	Configure, Rename, Duplicate, Share, Delete
Media File	Create project, Rename, Duplicate, Share, Delete

Configuration Tab

Proprieties

The Proprieties section refer to the proprieties that go with your project.

Section	Description
Media	This mention the embedded media file in the project.
Playbar	A visual playbar can be put as an overlay above the image. It is especially useful when you have a visual that consist of a long image that do a translation over time; like for a graphical music score. This feature has extra proprieties that you can reveal when you expand the list item. - Width: The width of the playbar based on a percent of the media width - Position X: The position of the playbar along the horizontal (X) axis - Position Y: The position of the playbar along the vertical (Y) axis - Rotation: Rotation of the playbar in degree (Useful to have a vertical or horizontal playbar or in-between) - Color: The color of the playbar
Slave Time Shift	You can specify to shift the playback position of the Slaves from the Master. For example, this could be useful if you don't use the same media file for the Master and the Slaves and the media doesn't align exactly in their time position. Also, this could be useful if you don't want to have the same position for a device that output to a public than the ones used to behind.
IP Port	You can set a different IP Port per project and will supersede the one set in the Main Preference. This could be useful if you want to have different groups on the same network and where each group are controlled by their respective Master device.

Markers

The Markers section refer to the markers that go with your project.

A marker allow you to save specific time positions that you can rapidly return at a later time. You can Add a marker using the button at the bottom of the list and modify or delete one with the button that you can find on the right side of the list item.

The edit or add menus use the same dialog as the Add marker button that is accessible from the Time Picker dialog. Please look at the Marker dialog of the User Interface section for more information on how to use it.

File Types

Mon, 01 Jan 0001 00:00:00 +0000

SyncFrame's specific file types

SyncFrame defines 3 file types to simplify the interaction with the application:

Extension	Description
.syncframe	The SyncFrame Project File is the main file that you will find in the SyncFrame's application directory. It consists of a directory package that contains your configuration file and your media. On Apple's platforms this will look like a single file, but on Android it will be a directory since we can't define a directory package on this platform. However, please keep the .syncframe extension when you meet one.
.syncframez	The SyncFrame Project Archive is a file that encapsulates a SyncFrame Project File in an archive. This is in order to simplify the sharing of your projects between different platforms and to prevent problems. Therefore, it is the recommended way of sharing to other devices.
.sfconfig	The SyncFrame Configuration File is the file that holds your configuration data. It is a simple JSON file, but linked to SyncFrame in order to make it possible to open the Project File on a platform that doesn't allow the directory package file type.

Supported Media Formats

Apple's Platforms

On the Apple platforms, the video player uses the native video playback manager (AVPlayer). This means that if your video work on Apple's native applications, then it should also work with SyncFrame.

The supported media formats are specific to your device model/generation and we recommend to test your files before using them in a live situation.

Android

On Android, the video player uses the media player ExoPlayer. You can find a list of supported media formats at this address: https://exoplayer.dev/supported-formats.html

Import/Export files to iOS

Mon, 01 Jan 0001 00:00:00 +0000

SyncFrame use the native methods of manipulating files on Apple devices. Therefore, you can use the Files app and the Share extension to move your files in and out of the SyncFrame's application directory.

Apple has very good guides to help you learn how to move your files between your applications in your device and between different devices. We recommend to read them so you have a good understanding on how they work:

Using Files app

Link:

https://support.apple.com/en-us/HT206481

Best for:

Manipulating your files directly inside your device to move them in and out of your application directory.

Using AirDrop

Best for:

Moving your files in and out of your device using a wireless connexion
Sharing your files to other people on your network that also use an Apple device

Using iTunes

Link:

https://support.apple.com/en-ca/HT201301

Best for:

Moving your files in and out of your device using a wired connexion

SyncFrame allow you to share a file or project using the native Share Extension. It is accessible from the actions menu that you can find in the Files tab of the right sidebar.

This is the recommended way of sharing a Project to another device since it will create and share a SyncFrame Project Archive (.syncframez) which is compatible on all platforms.

How to: Copy/Paste a Configuration

Mon, 01 Jan 0001 00:00:00 +0000

A Copy/Paste combination could be used to keep temporarily a backup of you configuration in memory while you test some modification or to copy a configuration to a second project.

The Copy/Paste menu is accessible from button situated at the top right of the right sidebar panel.

How to: Create a Project

Mon, 01 Jan 0001 00:00:00 +0000

Project files are media files with an attached configuration. This allow you to configure the different Proprieties so you can recall them between startup or when you switch to a different file. Also, this is useful to transfert your configuration to different devices so they all use the same setup.

There are multiple ways to create a SyncFrame project from the application depending from where you are, but first , make sure that you have imported a media file inside the application. Please look at the relevant section from this documentation based on your device.

After your file is imported, please proceed with one of this next section:

From a Media file

From the Files tab

With your media file from which you want to create a project opened:

Open the media file from which you want to create a project
Tap on the button on the far right of your media file to open the file menu.
Tap on Create project
A new menu will pop asking to Move or Duplicate the file.
- Move: Tap on Move if you don't want to keep your file in your Media list, but only embedded in your Project file.
- Duplicate: Tap on Duplicate if you want to keep your file where it is, but make a duplicate to embed in your project file
Modify you Proprieties and add Markers as you want for your project
Tap on the Save button that will pop at the bottom of the sidebar to save your configuration with your project.
A new project file with the same name as your media file will be created

From the Configuration Tab

With your media file from which you want to create a project opened:

Open the right sidebar and go inside the Configuration Tab
Modify you Proprieties and add Markers as you want for your project
Tap on the Save button that will pop at the bottom of the sidebar to save your configuration and create your project.
A new menu will pop asking to Move or Duplicate the file.
- Move: Tap on Move if you don't want to keep your file in your Media list, but only embedded in your Project file.
- Duplicate: Tap on Duplicate if you want to keep your file where it is, but make a duplicate to embed in your project file
A new project file with the same name as your media file will be created

From a Project file

If you want to have a project that use the same media file as another one, but with a different configuration file, you can duplicate your project file, then modify its configuration and save it.

How to: Duplicate a file

Mon, 01 Jan 0001 00:00:00 +0000

To duplicate a file (a media or a project file):

Open the right sidebar
Tap on the button on the far right of your file to open the file menu.
Tap on the Duplicate button
A duplicated file will be created with a “copy” string appended to its filename.

How to: Networking

Mon, 01 Jan 0001 00:00:00 +0000

SyncFrame connect the devices together using UDP Broadcast. Therefore, to establish a connection between your devices, you need to make sure to connect to the same network.

If you need to separate your devices into different groups to have multiple Coordinator devices that connect to different Auxiliary groups. You can do one of the following

Use different router (1 router per group)
Change the IP Port from your device (1 IP Port per group)

For the second method, your can change your device IP Port from the Preferences section of the application (if you want to change it globally and your Project's files have no IP Port set in their configuration). Alternatively, you can specify a specific IP Port inside your Project configuration. This last setup could be useful in case you want to have multiple groups for specific projects and connect all devices into one group for other projects. This way, the switch is automatic when you load a different project.

How to: Rename a file

Mon, 01 Jan 0001 00:00:00 +0000

To rename a file (a media or a project file):

Open the right sidebar
Tap on the button on the far right of your file to open the file menu.
Tap on the Rename button
A popup dialog will appear and let you change the filename.
Tap on OK when you are done renaming the file

How to: Resynchronize

Mon, 01 Jan 0001 00:00:00 +0000

Safety System

In the event that you accidentally quit the application during a performance, SyncFrame has a safety system that will automatically try to resynchronize to other devices.

The way it works is:

In all situations, SyncFrame will automatically save the file you are playing at the moment you switch to a new one. This way, your last loaded file will be automatically reloaded at the next startup. However, make sure to save as a Project File if you want to use a specific configuration to make sure that it is kept.
When you return to the application, whatever playing mode you were using will be switched to Auxiliary mode. This is done in order that a Coordinator device who lost connexion and stopped playing when it quits doesn't force the Auxiliary devices to resynchronize to a bad time position. For those who were following this lost Coordinator device will continue to play normally so they can keep playing while the Coordinator return.
When the device return to the application:
- a Auxiliary device will directly catch the Coordinator device connexion and continue normally. You are now good to continue normally!
- a Coordinator device will ask the other devices on the network for their position and will set itself to this one.
A last action is required to be manually done by yourself when you are the Coordinator device. It consists of reactivating the Coordinator mode when you see that your device is correctly reset to the same playing position as the Auxiliarys. This way, the Auxiliary devices will return to synchronize themselves to the Coordinator device.

Extra Actions

In the button bar for the playing mode (top center controls), you will find a Resync and a Force depending on if you are set to the Auxiliary or Coordinator mode. Those buttons can also be used to have more controls in this kind of situation. For example:

The Resync button can be used in case that you don't receive any information from a Coordinator device (like if the Coordinator lost its connexion) and you think you are out of sync from the other Auxiliary devices. This button will ask the other Auxiliarys for their position and your device will resynchronize to it.

The Force button can be used to force another Coordinator device on the network to set itself into Auxiliary mode. For example, if a Coordinator device lost its connexion, it could be specified that another device takes the lead by temporarily set itself as the Coordinator. Then, when the main Coordinator device return it could take back the lead setting itself into Coordinator mode and then by tapping the Force button.

Release Notes

Mon, 01 Jan 0001 00:00:00 +0000

0.0.1

Currently in Beta Test

Welcome

Wed, 01 Jan 2020 00:00:00 +0000

Welcome to my personal website.

This is my personal online space where I'll publish some of my projects I'll be working on throughout the years like my Applications, Scripts, Tools, Music and DIY stuffs.

Make sure to come back from time to time to see some new publications or subscribe to my Newsletter or RSS feed to better know rapidly!

SyncFrame

Fri, 30 Aug 2019 00:00:00 +0000

SyncFrame is an application to sync video playback on multiple devices. It is especially suited as a contemporary musical score player.

Privacy Policy

Thu, 29 Aug 2019 00:00:00 +0000

Last updated: August 29, 2019

Your privacy is important to us and we strive to respect your privacy by treating your information and data collected in a lawful, transparent, fair manner and without affecting the exercise of your rights as a person concerned.

Please read the following information carefully before using any of our services or products or our website (the Services) to understand our practices and procedures. By using one of our Services, you acknowledge that you have accepted the terms of this privacy policy. If you disagree with these terms, do not install and/or use our Services. If the “accept” or “reject” options appear, click “reject”.

We may change this Privacy Policy from time to time and without notice. When we do, we will update the Last Updated date above. It is therefore important that you regularly review this Privacy Policy to ensure that you are aware of any changes.

If this document has been translated into a language other than French, in the event of a dispute concerning its interpretation, the content of the French version will prevail.

Collection of information and use

The few information collected is used for the purpose of ensuring or improving our Services. Your personal data is not used for marketing purposes unless you are asked, for example, to collect user testimonials.

Personal data

When you sign up for our newsletters, participate in our beta test, your personal data can be collected and saved. (Name and email address)

Website

When you visit our website, we use cookies to collect information about the use of the site such as the type and version of your browser and the operating system used.

Communications by e-mail

In order to provide better services and to ensure that communication has been delivered, we may use “image tracking” when contacting you to determine whether or not you are reading our emailed communications.

When you subscribe to our newsletter, you agree that we keep your email address to send you this newsletter. You will be able to withdraw from our mailing list at any time.

Customer Support

In order to ensure proper follow-up, we keep a record of communications, including attachments and information that you voluntarily decide to share with us for troubleshooting purposes, each time you contact us.

Agreement during the purchase

We will eventually collect and store your personal data to fulfill our contractual obligations to you. For example, we may need to keep a copy of your email address if it is part of the license for the product you are buying.

At the moment we are dealing with subcontractors for the sale of our software such as the App Store and the Play Store. In this situation, we do not receive any personal data. If you need to reactivate a license for your software or any other assistance from us, we will need a proof of purchase, such as a sales receipt, to ensure that you are our customer.

Analytic

Software

When using our beta software, we may collect information about your device such as: model, operating system, language used, and software version installed. These will be sent directly by you by email or by the test platform used (for example: Apple TestFlight). In such cases, please refer to the privacy policy of this third party platform.

This information will be used to diagnose and solve problems.

In certain circumstances, we may be required to disclose your personal information (legal obligation, legal process, litigation, claims filed by public and governmental authorities in your country of residence or in another country).

In addition, in the event of a reorganization, a merge or a sale, we may transfer, in whole or in part, the personal information collected to the relevant third party.

Contact

If you have any requests regarding our use of your personal information or any other question relating to your confidential data, you can contact us at any time by visiting our Contact page.

Note that the judicial district of Montreal (in the municipality of Montreal) applies in the event of a dispute.

Donate

Fri, 19 Jul 2019 00:00:00 +0000

I'm giving many hours building tools, giving scripts and helping others online. If you or your company use any of my projects or simply like what I’m doing, please consider backing me so I can continue maintaining and evolving these projects and create new ones.

Mon, 01 Jan 0001 00:00:00 +0000

RSS Feeds

Follow me with your RSS feed reader to be informed of new contents.

Posts

Projects

Contact

Mon, 01 Jan 0001 00:00:00 +0000

Form Sent

Mon, 01 Jan 0001 00:00:00 +0000

Guillaume Barrette

ReaScript: Independant Time Offset

About this Script

Installation

Manually

How it works

Keyboard Hotkeys:

Main View: The Player View

Controls

Title Bar (Menus)

Playing Modes

Top left controls (Visual Modes)

Top right controls (Audio)

Bottom controls (Playback Controls)

Dialogs

Playback Rate

Time Picker

Marker

Preferences

Right Sidebar: Access Files and Configuration

Files Tab

Actions

Configuration Tab

Proprieties

Markers

File Types

SyncFrame's specific file types

Supported Media Formats

Apple's Platforms

Android

Import/Export files to iOS

Using Files app

Link:

Best for:

Using AirDrop

Links:

Best for:

Using iTunes

Link:

Best for:

Sharing from SyncFrame

How to: Copy/Paste a Configuration

How to: Create a Project

From a Media file

From the Files tab

From the Configuration Tab

From a Project file

How to: Duplicate a file

How to: Networking

How to: Rename a file

How to: Resynchronize

Safety System

Extra Actions

Release Notes

0.0.1

Welcome

SyncFrame

Privacy Policy

Collection of information and use

Personal data

Website

Communications by e-mail

Newsletter

Customer Support

Agreement during the purchase

Analytic

Software

Information sharing

Contact

Donate

RSS Feeds

Contact

Form Sent