tictacsync 0.4a0__tar.gz → 1.4.6b0__tar.gz

{tictacsync-0.4a0/tictacsync.egg-info → tictacsync-1.4.6b0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.1
 Name: tictacsync
-Version: 0.4a0
-Summary: command for syncing audio video recordings
+Version: 1.4.6b0
+Summary: commands for syncing audio video recordings
 Home-page: https://tictacsync.org/
 Author: Raymond Lutz
 Author-email: lutzrayblog@mac.com
-Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: License :: OSI Approved :: MIT License
@@ -23,21 +23,27 @@ License-File: LICENSE
 
 # tictacsync
 
-## Warning: this is at pre-alpha stage
+## Warning: this is at beta stage
 
 Unfinished sloppy code ahead, but should run without errors. Some functionalities are still missing. Don't run the code without parental supervision. Suggestions and enquiries are welcome via the [lists hosted on sourcehut](https://sr.ht/~proflutz/TicTacSync/lists).
 
 ## Description
 
-`tictacsync` is a python script to sync audio and video files shot
-with [dual system sound](https://www.learnlightandsound.com/blog/2017/2/23/how-to-record-sound-for-video-dual-systemsync-sound)  using a specific hardware timecode generator
-called [Tic Tac Sync](https://tictacsync.org). The timecode is named YaLTC for *yet
-another longitudinal time code* and should be recorded on a scratch
-track on each device for the syncing to be performed, later in _postprod_ before editing.
-
+`tictacsync` is a python script to sync, cut and join audio files against camera files shot using a specific hardware timecode generator
+called [Tic Tac Sync](https://tictacsync.org). The timecode is named TicTacCode and should be recorded on a scratch
+track on each device for `tictacsync` to work.
 ## Status
 
-`tictacsync`  scans for audio video files and displays their starting time and then merges overlapping audio and video recordings. Multicam syncing with one stereo audio recorder has been tested (spring 2023, [see demo](https://youtu.be/pklTSTi7cqs)). Multi audio recorders coming soon... 
+Feature complete! `tictacsync`  scans for audio video files and then merges overlapping audio and video recordings, It
+
+* Decodes the TicTacCode audio track alongside your audio tracks
+* Establishes UTC start time (and end time) within 100 μs!
+* Syncs, cuts and joins any concurrent audio to camera files (using `FFmpeg`)
+* Processes _multiple_ audio recorders
+* Corrects device clock drift so _both_ ends coincide (thanks to `sox`)
+* Sets video metadata TC of multicam files for NLE timeline alignement
+* Writes _synced_ ISO files with dedicated file names declared in `tracks.txt`
+* Produces nice plots.
 
 
 ## Installation
@@ -52,7 +58,7 @@ Then pip install the syncing program:
 This should install python dependencies _and_ the `tictacsync` command.
 ## Usage
 
-Download multiple sample files [here](https://nuage.lutz.quebec/s/nY54nQyxmZbTLti/download/dailies.zip) (625 MB, sorry) unzip and run:
+Download multiple sample files [here](https://nuage.lutz.quebec/s/4jw4xgqysLPS8EQ/download/dailies1_3.zip) (700+ MB, sorry) unzip and run:
 
     > tictacsync dailies/loose
 The program `tictacsync` will recursively scan the directory given as argument, find all audio that coincide with any video and merge them into a subfolder named `SyncedMedia`. When the argument is an unique media file (not a directory), no syncing will occur but the decoded starting time will be printed to stdout:
@@ -67,19 +73,22 @@ The program `tictacsync` will recursively scan the directory given as argument,
 If shooting multicam, put clips in their respective directories (using the camera name as folder name) _and_ the audio under their own directory. `tictacsync` will detect that structured input and will generate multicam folders ready to be imported into your NLE (for now only DaVinci Resolve has been validated).
 
 ## Options
+#### `-v`
 
 For a very verbose output add the `-v` flag:
 
     > tictacsync -v dailies/loose/MVI_0024.MP4
-
+#### `--terse`
 For a one line output (or to suppress the progress bars) use the `--terse` flag:
 
 	> tictacsync --terse dailies/loose/MVI_0024.MP4 
 	dailies/loose/MVI_0024.MP4 UTC:2024-03-12 23:07:01.4281 pulse: 27450 in chan 0
+#### `--isos`
 
-To also produce _synced_ ISO audio files, specify `--isos` . A directory named `ISOs` will contain _for each synced video_ a set of audio files of exact same length, padded or trimmed to coincide with the video track. After re-editing and re-mixing a `remergemix` command will resync the new sound track with the video [TODO].
+Specifying `--isos` produces _synced_ ISO audio files: for each synced \<video-clip\> a directory named `<video-clip>_ISO` will contain a set of ISO audio files each of exact same length, padded or trimmed to coincide with the video start. After re-editing and re-mixing in your DAW of choice a `remergemix` command will resync the new audio with the video and _the new sound track will be updated on your NLE timeline_, _automagically_ on some NLEs or on command for [Davinci Resolve](https://www.niwa.nu/dr-scripts/).
 
 	> tictacsync --isos dailies/structured
+#### `-p`
 
 When called with the `-p` flag, zoomable plots will be produced for diagnostic purpose (close the plotting window for the 2nd one) and the decoded starting time will be output to stdin:
 

{tictacsync-0.4a0 → tictacsync-1.4.6b0}/README.md

@@ -1,20 +1,26 @@
 # tictacsync
 
-## Warning: this is at pre-alpha stage
+## Warning: this is at beta stage
 
 Unfinished sloppy code ahead, but should run without errors. Some functionalities are still missing. Don't run the code without parental supervision. Suggestions and enquiries are welcome via the [lists hosted on sourcehut](https://sr.ht/~proflutz/TicTacSync/lists).
 
 ## Description
 
-`tictacsync` is a python script to sync audio and video files shot
-with [dual system sound](https://www.learnlightandsound.com/blog/2017/2/23/how-to-record-sound-for-video-dual-systemsync-sound)  using a specific hardware timecode generator
-called [Tic Tac Sync](https://tictacsync.org). The timecode is named YaLTC for *yet
-another longitudinal time code* and should be recorded on a scratch
-track on each device for the syncing to be performed, later in _postprod_ before editing.
-
+`tictacsync` is a python script to sync, cut and join audio files against camera files shot using a specific hardware timecode generator
+called [Tic Tac Sync](https://tictacsync.org). The timecode is named TicTacCode and should be recorded on a scratch
+track on each device for `tictacsync` to work.
 ## Status
 
-`tictacsync`  scans for audio video files and displays their starting time and then merges overlapping audio and video recordings. Multicam syncing with one stereo audio recorder has been tested (spring 2023, [see demo](https://youtu.be/pklTSTi7cqs)). Multi audio recorders coming soon... 
+Feature complete! `tictacsync`  scans for audio video files and then merges overlapping audio and video recordings, It
+
+* Decodes the TicTacCode audio track alongside your audio tracks
+* Establishes UTC start time (and end time) within 100 μs!
+* Syncs, cuts and joins any concurrent audio to camera files (using `FFmpeg`)
+* Processes _multiple_ audio recorders
+* Corrects device clock drift so _both_ ends coincide (thanks to `sox`)
+* Sets video metadata TC of multicam files for NLE timeline alignement
+* Writes _synced_ ISO files with dedicated file names declared in `tracks.txt`
+* Produces nice plots.
 
 
 ## Installation
@@ -29,7 +35,7 @@ Then pip install the syncing program:
 This should install python dependencies _and_ the `tictacsync` command.
 ## Usage
 
-Download multiple sample files [here](https://nuage.lutz.quebec/s/nY54nQyxmZbTLti/download/dailies.zip) (625 MB, sorry) unzip and run:
+Download multiple sample files [here](https://nuage.lutz.quebec/s/4jw4xgqysLPS8EQ/download/dailies1_3.zip) (700+ MB, sorry) unzip and run:
 
     > tictacsync dailies/loose
 The program `tictacsync` will recursively scan the directory given as argument, find all audio that coincide with any video and merge them into a subfolder named `SyncedMedia`. When the argument is an unique media file (not a directory), no syncing will occur but the decoded starting time will be printed to stdout:
@@ -44,19 +50,22 @@ The program `tictacsync` will recursively scan the directory given as argument,
 If shooting multicam, put clips in their respective directories (using the camera name as folder name) _and_ the audio under their own directory. `tictacsync` will detect that structured input and will generate multicam folders ready to be imported into your NLE (for now only DaVinci Resolve has been validated).
 
 ## Options
+#### `-v`
 
 For a very verbose output add the `-v` flag:
 
     > tictacsync -v dailies/loose/MVI_0024.MP4
-
+#### `--terse`
 For a one line output (or to suppress the progress bars) use the `--terse` flag:
 
 	> tictacsync --terse dailies/loose/MVI_0024.MP4 
 	dailies/loose/MVI_0024.MP4 UTC:2024-03-12 23:07:01.4281 pulse: 27450 in chan 0
+#### `--isos`
 
-To also produce _synced_ ISO audio files, specify `--isos` . A directory named `ISOs` will contain _for each synced video_ a set of audio files of exact same length, padded or trimmed to coincide with the video track. After re-editing and re-mixing a `remergemix` command will resync the new sound track with the video [TODO].
+Specifying `--isos` produces _synced_ ISO audio files: for each synced \<video-clip\> a directory named `<video-clip>_ISO` will contain a set of ISO audio files each of exact same length, padded or trimmed to coincide with the video start. After re-editing and re-mixing in your DAW of choice a `remergemix` command will resync the new audio with the video and _the new sound track will be updated on your NLE timeline_, _automagically_ on some NLEs or on command for [Davinci Resolve](https://www.niwa.nu/dr-scripts/).
 
 	> tictacsync --isos dailies/structured
+#### `-p`
 
 When called with the `-p` flag, zoomable plots will be produced for diagnostic purpose (close the plotting window for the 2nd one) and the decoded starting time will be output to stdin:
 

{tictacsync-0.4a0 → tictacsync-1.4.6b0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "rb") as f:
     long_descr = f.read().decode("utf-8")
 
 long_description = 'CLI for syncing audio video \
-	files containing an audio YaLTC sync track.'
+	files containing an audio TicTacCode sync track.'
 
 setup(
     name = "tictacsync",
@@ -15,24 +15,29 @@ setup(
     },
     install_requires=[
         'sox>=1.4.1',
-        'ffmpeg_python>=0.2.0', 
+        'ffmpeg_python>=0.2.0',
         'loguru>=0.6.0',
         'matplotlib>=3.7.1',
         'numpy>=1.24.3',
         'rich>=10.12.0',
         'lmfit',
+        'scikit-image',
         'scipy>=1.10.1',
-        'scikit-learn==1.2.2'], 
+        'platformdirs',
+        ], 
     python_requires='>=3.10',
     entry_points = {
         "console_scripts": [
         'tictacsync = tictacsync.entry:main',
-        'remergemix = tictacsync.remergemix:main',
+        'mamreap = tictacsync.mamreap:main',
+        'mamdav = tictacsync.mamdav:called_from_cli',
+        'mamsync = tictacsync.mamsync:main',
+        'mamconf = tictacsync.mamconf:main',
         'multi2polywav = tictacsync.multi2polywav:main',
         ]
         },
-    version = '0.4a',
-    description = "command for syncing audio video recordings",
+    version = '1.4.6-beta',
+    description = "commands for syncing audio video recordings",
     long_description_content_type='text/markdown',
     long_description = long_descr,
     include_package_data=True,
@@ -41,7 +46,7 @@ setup(
     author_email = "lutzrayblog@mac.com",
 	url ='https://tictacsync.org/',
     classifiers=[
-          'Development Status :: 2 - Pre-Alpha',
+          'Development Status :: 4 - Beta',
           'Environment :: Console',
           'Intended Audience :: End Users/Desktop',
           'License :: OSI Approved :: MIT License',