sushi-sub-next 0.6.3__tar.gz

sushi_sub_next-0.6.3/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2014-2017 Victor Efimov
+Copyright (c) 2025 C1fer 
+
+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:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+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.

sushi_sub_next-0.6.3/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: sushi-sub-next
+Version: 0.6.3
+Summary: Subtitle Synchronization Tool
+License: MIT
+License-File: LICENSE
+License-File: LICENSES/OpenCV.txt
+License-File: LICENSES/SciPy.txt
+Keywords: subtitle,sync
+Author: C1fer
+Requires-Python: >=3.13
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Text Processing
+Requires-Dist: numpy (>=2.3.4,<3.0.0)
+Requires-Dist: opencv-python (>=4.8.1.78,<5.0.0.0)
+Requires-Dist: scipy (>=1.16.2,<2.0.0)
+Project-URL: Repository, https://github.com/C1fer/sushi-next
+Description-Content-Type: text/markdown
+
+## Sushi-next
+Automatic shifter for SRT and ASS subtitle based on audio streams.
+
+*Python 3.13 fork of https://github.com/tp7/Sushi.*
+
+Credits to [DYY-Studio](https://github.com/DYY-Studio/Sushi) for the initial v3.13 porting work.
+
+### Purpose
+Imagine you've got a subtitle file synced to one video file, but you want to use these subtitles with some other video you've got via totally legal means. The common example is TV vs. BD releases, PAL vs. NTSC video and releases in different countries. In a lot of cases, subtitles won't match right away and you need to sync them.
+
+The purpose of this script is to avoid all the hassle of manual syncing. It attempts to synchronize subtitles by finding similarities in audio streams. The script is very fast and can be used right when you want to watch something.
+
+### How it works
+You need to provide two audio files and a subtitle file that matches one of those files. For every line of the subtitles, the script will extract corresponding audio from the source audio stream and will try to find the closest similar pattern in the destination audio stream, obtaining a shift value which is later applied to the subtitles.
+
+Detailed explanation of Sushi workflow and description of command-line arguments can be found in the [wiki][2].
+
+### Usage
+The minimal command line looks like this:
+```
+python -m sushi --src hdtv.wav --dst bluray.wav --script subs.ass
+```
+Output file name is optional - `"{destination_path}.sushi.{subtitles_format}"` is used by default. See the [usage][3] page of the wiki for further examples.
+
+Do note that WAV is not the only format Sushi can work with. It can process audio/video files directly and decode various audio formats, provided that ffmpeg is available. For additional info refer to the [Demuxing][4] part of the wiki.
+
+### Requirements
+Sushi should work on Windows, Linux and OS X. Please open an issue if it doesn't. To run it, you have to have the following installed:
+
+1. [Python 3.13 or higher][5]
+2. [NumPy][6] (2.3.4 or newer)
+3. [SciPy][6] (1.16.2 or newer)
+4. [OpenCV 4.4.x or newer][7]
+
+Optionally, you might want:
+
+1. [FFmpeg][9] for any kind of demuxing
+2. [MkvExtract][10] for faster timecodes extraction when demuxing
+3. [SCXvid-standalone][11] if you want Sushi to make keyframes
+4. [Colorama](https://github.com/tartley/colorama) to add colors to console output on Windows
+
+#### Installation on Windows
+<!-- The provided Windows binaries include all required components and Colorama so you don't have to install them if you use the binary distribution. You still have to download other applications yourself if you want to use Sushi's demuxing capabilities. -->
+Because the "maintainer" of this fork does not run Windows and is not interested in providing binaries, you are kind of on your own.
+The following steps are untested (see requirements earlier):
+
+1. Install Python (64 bit).
+2. Install OpenCV.
+3. Run `pip install sushi-sub-next colorama` on a terminal.
+4. Use it as `sushi args…` on a terminal.
+
+If anyone wants to provide proper installation steps or a binary for Windows, please open a PR or get in contact.
+
+#### Installation on Mac OS X
+
+No binary packages are provided for OS X right now so you'll have to use the script form. Assuming you have Python 3, pip and [homebrew](http://brew.sh/) installed, run the following:
+```bash
+brew tap homebrew/science
+brew install git opencv
+pip3 install numpy
+# install some optional dependencies
+brew install ffmpeg mkvtoolnix
+# install sushi
+pip3 install sushi-sub-next
+# use sushi
+sushi args…
+```
+
+#### Installation on Linux
+
+If you have apt-get available, the installation process is trivial.
+```bash
+sudo apt-get update
+sudo apt-get install git python3 python3-numpy python3-opencv
+
+pip3 install --user sushi-sub-next
+# if ~/.local/bin is in your PATH
+sushi args…
+# otherwise
+python3 -m sushi args…
+```
+
+For other distros, pick corresponding package names for the python, numpy, and opencv dependencies.
+
+### Limitations
+This script will never be able to property handle frame-by-frame typesetting. If underlying video stream changes (e.g. has different telecine pattern), you might get incorrect output.
+
+This script cannot improve bad timing. If original lines are mistimed, they will be mistimed in the output file too.
+
+In short, while this might be safe for immediate viewing, you probably shouldn't use it to blindly shift subtitles for permanent storing.
+
+
+  <!-- [1]: https://github.com/tp7/Sushi/releases -->
+  [2]: https://github.com/tp7/Sushi/wiki
+  [3]: https://github.com/tp7/Sushi/wiki/Examples
+  [4]: https://github.com/tp7/Sushi/wiki/Demuxing
+  [5]: https://www.python.org/downloads/
+  [6]: http://www.scipy.org/scipylib/download.html
+  [7]: http://opencv.org/
+  [9]: http://www.ffmpeg.org/download.html
+  [10]: http://www.bunkus.org/videotools/mkvtoolnix/downloads.html
+  [11]: https://github.com/soyokaze/SCXvid-standalone/releases
+

sushi_sub_next-0.6.3/README.md

@@ -0,0 +1,102 @@
+## Sushi-next
+Automatic shifter for SRT and ASS subtitle based on audio streams.
+
+*Python 3.13 fork of https://github.com/tp7/Sushi.*
+
+Credits to [DYY-Studio](https://github.com/DYY-Studio/Sushi) for the initial v3.13 porting work.
+
+### Purpose
+Imagine you've got a subtitle file synced to one video file, but you want to use these subtitles with some other video you've got via totally legal means. The common example is TV vs. BD releases, PAL vs. NTSC video and releases in different countries. In a lot of cases, subtitles won't match right away and you need to sync them.
+
+The purpose of this script is to avoid all the hassle of manual syncing. It attempts to synchronize subtitles by finding similarities in audio streams. The script is very fast and can be used right when you want to watch something.
+
+### How it works
+You need to provide two audio files and a subtitle file that matches one of those files. For every line of the subtitles, the script will extract corresponding audio from the source audio stream and will try to find the closest similar pattern in the destination audio stream, obtaining a shift value which is later applied to the subtitles.
+
+Detailed explanation of Sushi workflow and description of command-line arguments can be found in the [wiki][2].
+
+### Usage
+The minimal command line looks like this:
+```
+python -m sushi --src hdtv.wav --dst bluray.wav --script subs.ass
+```
+Output file name is optional - `"{destination_path}.sushi.{subtitles_format}"` is used by default. See the [usage][3] page of the wiki for further examples.
+
+Do note that WAV is not the only format Sushi can work with. It can process audio/video files directly and decode various audio formats, provided that ffmpeg is available. For additional info refer to the [Demuxing][4] part of the wiki.
+
+### Requirements
+Sushi should work on Windows, Linux and OS X. Please open an issue if it doesn't. To run it, you have to have the following installed:
+
+1. [Python 3.13 or higher][5]
+2. [NumPy][6] (2.3.4 or newer)
+3. [SciPy][6] (1.16.2 or newer)
+4. [OpenCV 4.4.x or newer][7]
+
+Optionally, you might want:
+
+1. [FFmpeg][9] for any kind of demuxing
+2. [MkvExtract][10] for faster timecodes extraction when demuxing
+3. [SCXvid-standalone][11] if you want Sushi to make keyframes
+4. [Colorama](https://github.com/tartley/colorama) to add colors to console output on Windows
+
+#### Installation on Windows
+<!-- The provided Windows binaries include all required components and Colorama so you don't have to install them if you use the binary distribution. You still have to download other applications yourself if you want to use Sushi's demuxing capabilities. -->
+Because the "maintainer" of this fork does not run Windows and is not interested in providing binaries, you are kind of on your own.
+The following steps are untested (see requirements earlier):
+
+1. Install Python (64 bit).
+2. Install OpenCV.
+3. Run `pip install sushi-sub-next colorama` on a terminal.
+4. Use it as `sushi args…` on a terminal.
+
+If anyone wants to provide proper installation steps or a binary for Windows, please open a PR or get in contact.
+
+#### Installation on Mac OS X
+
+No binary packages are provided for OS X right now so you'll have to use the script form. Assuming you have Python 3, pip and [homebrew](http://brew.sh/) installed, run the following:
+```bash
+brew tap homebrew/science
+brew install git opencv
+pip3 install numpy
+# install some optional dependencies
+brew install ffmpeg mkvtoolnix
+# install sushi
+pip3 install sushi-sub-next
+# use sushi
+sushi args…
+```
+
+#### Installation on Linux
+
+If you have apt-get available, the installation process is trivial.
+```bash
+sudo apt-get update
+sudo apt-get install git python3 python3-numpy python3-opencv
+
+pip3 install --user sushi-sub-next
+# if ~/.local/bin is in your PATH
+sushi args…
+# otherwise
+python3 -m sushi args…
+```
+
+For other distros, pick corresponding package names for the python, numpy, and opencv dependencies.
+
+### Limitations
+This script will never be able to property handle frame-by-frame typesetting. If underlying video stream changes (e.g. has different telecine pattern), you might get incorrect output.
+
+This script cannot improve bad timing. If original lines are mistimed, they will be mistimed in the output file too.
+
+In short, while this might be safe for immediate viewing, you probably shouldn't use it to blindly shift subtitles for permanent storing.
+
+
+  <!-- [1]: https://github.com/tp7/Sushi/releases -->
+  [2]: https://github.com/tp7/Sushi/wiki
+  [3]: https://github.com/tp7/Sushi/wiki/Examples
+  [4]: https://github.com/tp7/Sushi/wiki/Demuxing
+  [5]: https://www.python.org/downloads/
+  [6]: http://www.scipy.org/scipylib/download.html
+  [7]: http://opencv.org/
+  [9]: http://www.ffmpeg.org/download.html
+  [10]: http://www.bunkus.org/videotools/mkvtoolnix/downloads.html
+  [11]: https://github.com/soyokaze/SCXvid-standalone/releases

sushi_sub_next-0.6.3/licenses/OpenCV.txt

@@ -0,0 +1,33 @@
+By downloading, copying, installing or using the software you agree to this license.
+If you do not agree to this license, do not download, install,
+copy or use the software.
+
+
+                          License Agreement
+               For Open Source Computer Vision Library
+                       (3-clause BSD License)
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+  * Redistributions of source code must retain the above copyright notice,
+    this list of conditions and the following disclaimer.
+
+  * Redistributions in binary form must reproduce the above copyright notice,
+    this list of conditions and the following disclaimer in the documentation
+    and/or other materials provided with the distribution.
+
+  * Neither the names of the copyright holders nor the names of the contributors
+    may be used to endorse or promote products derived from this software
+    without specific prior written permission.
+
+This software is provided by the copyright holders and contributors "as is" and
+any express or implied warranties, including, but not limited to, the implied
+warranties of merchantability and fitness for a particular purpose are disclaimed.
+In no event shall copyright holders or contributors be liable for any direct,
+indirect, incidental, special, exemplary, or consequential damages
+(including, but not limited to, procurement of substitute goods or services;
+loss of use, data, or profits; or business interruption) however caused
+and on any theory of liability, whether in contract, strict liability,
+or tort (including negligence or otherwise) arising in any way out of
+the use of this software, even if advised of the possibility of such damage.

sushi_sub_next-0.6.3/licenses/SciPy.txt

@@ -0,0 +1,31 @@
+Copyright (c) 2001, 2002 Enthought, Inc.
+All rights reserved.
+
+Copyright (c) 2003-2012 SciPy Developers.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+  a. Redistributions of source code must retain the above copyright notice,
+     this list of conditions and the following disclaimer.
+  b. Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+  c. Neither the name of Enthought nor the names of the SciPy Developers
+     may be used to endorse or promote products derived from this software
+     without specific prior written permission.
+
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+THE POSSIBILITY OF SUCH DAMAGE.
+

sushi_sub_next-0.6.3/pyproject.toml

@@ -0,0 +1,31 @@
+[tool.poetry]
+name = "sushi-sub-next"
+version = "0.6.3"
+description = "Subtitle Synchronization Tool"
+authors = ["C1fer"]
+license = "MIT"
+readme = "README.md"
+repository = "https://github.com/C1fer/sushi-next"
+keywords = ["subtitle", "sync"]
+classifiers = [
+    'Development Status :: 5 - Production/Stable',
+    'Programming Language :: Python :: 3.13',
+    'Topic :: Multimedia :: Sound/Audio',
+    'Topic :: Text Processing',
+]
+packages = [
+    { include = "sushi" }
+]
+
+[tool.poetry.dependencies]
+python = ">=3.13"
+numpy = "^2.3.4"
+scipy = "^1.16.2"
+opencv-python = "^4.8.1.78"
+
+[tool.poetry.scripts]
+sushi = "sushi.__main__:main"
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"