v1.1.0

Release v1.1.0 : HighlightLocator

Update Details

• Added Support for Twitch:

  • Users can now select Twitch as the source for highlight or original videos. When prompted to enter the URLs for highlight and original videos, simply input YouTube or Twitch URLs, and the system will automatically detect the source.

• Support for Chinese and English Interfaces:

  • For English users:
    • If using the source code, please run main_en.py.
    • If using the prebuilt executables, choose HighlightLocator_en.exe or HighlightLocator_dist_en.zip.
  • For Chinese users:
    • If using the source code, please run main.py.
    • If using the prebuilt executables, choose HighlightLocator.exe or HighlightLocator_dist.zip.

• Improved Display Logic:

  • Enhanced text layout and display logic to improve user experience.

Features Overview

HighlightLocator helps you quickly locate the position of highlight videos (short audio) within the timeline of original live streams or videos. Key features include:

1. Multi-Platform Support : Supports locating the position of highlight videos from YouTube and Twitch within the original video.
2. Fast Processing : Analyze a 5-hour live stream in approximately 5 minutes (depending on computer performance).
3. Language-Agnostic : Accurately matches the correct position regardless of language, speaker, or volume.
4. User-Friendly : Simply input the URLs of the highlight and original videos, along with the desired time range, to quickly locate the position.
5. Error-Tolerant : Maintains a certain level of accuracy even with noise or effects in the highlight video.

Known Issues

• Potential Errors: There may still be undetected issues.
• Accuracy Testing: Further testing is required to validate matching precision.
• Noise Threshold: The tolerance limits for noise and effects have not been fully defined.

For detailed instructions and system requirements, please refer to the README.
We welcome your feedback and contributions to make this project even better!

更新內容

• 新增對 Twitch 的支援：

  • 現在用戶可以選擇使用 twitch 當做精華影片或是原始影片的來源了。當系統要求輸入精華影片及原始影片網址時，直接輸入 youtube 或是 twitch 網址即可，系統會自動辨識來源

• 支援中英文介面：

  • 英文使用者若使用原始碼，請執行 main_en.py，若使用執行檔，請選擇 HighlightLocator_en.exe 或 HighlightLocator_dist_en.zip。
  • 中文使用者若使用原始碼，請執行 main.py，若使用執行檔，請選擇 HighlightLocator.exe 或 HighlightLocator_dist.zip。

• 優化顯示邏輯：

  • 改進了介面文字排列和顯示邏輯，提升使用者體驗。

功能概述

HighlightLocator 幫助您快速定位精華影片（短音檔）在原始直播或影片中的時間軸位置，主要功能包括：

1. 多平台支援：支援 YouTube 和 Twitch 精華影片在原影片中的位置定位。
2. 快速處理：分析 5 小時的直播影片僅需約 5 分鐘（視電腦效能而定）。
3. 不限語言：無論語言、說話者或音量，均可匹配到正確位置。
4. 操作簡單：只需輸入精華影片與原影片的網址，以及查詢的時間點，即可快速定位。
5. 容錯處理：即使精華影片中有雜音或特效，也能保持一定的準確度。

已知問題

• 未知錯誤：可能存在尚未發現的錯誤。
• 準確性測試：匹配的準確性仍需進一步驗證。
• 雜音處理閾值：對雜音和特效的容忍範圍尚未完全確定。

詳細的使用說明與系統需求，請參考 README
歡迎提供您的反饋與貢獻，讓這個專案變得更好！

v1.0.1

Release v1.0.1 : HighlightLocator

Update Details

• New English Interface :
  Users can now switch to an English interface.

  • For English users : Run main_en.py if using the source code, or select HighlightLocator_en.exe or HighlightLocator_dist_en.zip if using the prebuilt executables.
  • For Chinese users : Run main.py if using the source code, or select HighlightLocator.exe or HighlightLocator_dist.zip if using the prebuilt executables.

• Display Logic Improvements:
  Enhanced text layout and display logic for a better user experience.

• Source Code Changes :

  1. File Name Updates:
     • split_large_audio.py renamed to split_audio_large_segments.py.
     • split_audio_file.py renamed to sliding_audio_split.py.
  2. Class Name Updates:
     • split_large_audio_file renamed to LargeAudioSplitter.
     • splitAudio renamed to SlidingWindowProcessor.

Features Overview

HighlightLocator helps you quickly locate the position of highlight clips (short audio) within the timeline of original live streams or videos. Key features include :

1. Supports locating the position of YouTube highlight clips within the original video.
2. Fast processing : Analyze a 5-hour live stream in approximately 5 minutes (depending on computer performance).
3. Language-agnostic : Accurately matches the correct position regardless of language, speaker, or volume.
4. User-friendly : Simply input the URLs of the highlight clip and the original video, along with the desired time range, to quickly locate the position.
5. Error-tolerant : Maintains a certain level of accuracy even with noise or effects in the highlight clip.

Known Issues

• Potential Errors : There may still be undetected issues.
• Accuracy Validation : Further testing is needed to confirm matching precision.
• Noise Threshold : The tolerance limits for noise and effects are not yet fully defined.

For detailed instructions and system requirements, please refer to the README.
We welcome your feedback and contributions to make this project even better!

更新內容

• 新增英文介面：
  現在用戶可以選擇英文介面。

  • 英文使用者若使用原始碼，請執行 main_en.py，若使用執行檔，請選擇 HighlightLocator_en.exe 或 HighlightLocator_dist_en.zip。
  • 中文使用者請選擇原始碼執行 main.py，執行檔選擇 HighlightLocator.exe 或 HighlightLocator_dist.zip。

• 優化顯示邏輯：
  改進了介面文字排列和顯示邏輯，提升使用者體驗。

• 原始碼變更：

  1. 文件名稱調整：
     • split_large_audio.py 更名為 split_audio_large_segments.py。
     • split_audio_file.py 更名為 sliding_audio_split.py。
  2. 類別名稱調整：
     • 原 split_large_audio_file 更名為 LargeAudioSplitter。
     • 原 splitAudio 更名為 SlidingWindowProcessor。

功能概述

HighlightLocator 幫助您快速定位精華影片（短音檔）在原始直播或影片中的時間軸位置，主要功能包括：

1. 支援定位 YouTube 精華影片在原影片中的位置。
2. 快速處理：5 小時的直播影片僅需約 5 分鐘完成分析(視電腦效能而定)。
3. 不限語言：無論語言、說話者或音量，均可匹配到正確位置。
4. 操作簡單：輸入精華影片和原影片的網址，以及查詢的時間點，即可快速定位。
5. 容錯處理：即使精華影片中有雜音或特效，仍能保持一定的準確度

已知問題

• 未知錯誤：可能存在尚未發現的錯誤。
• 準確性測試：匹配的準確性仍需進一步驗證。
• 雜音處理閾值：對雜音和特效的容忍範圍尚未完全確定。

詳細的使用說明與系統需求，請參考 README
歡迎提供您的反饋與貢獻，讓這個專案變得更好！

v1.0.0

Release v1.0.0 : HighlightLocator

Overview

The first official version of this project provides a simple and efficient tool to help users locate the position of highlight videos (short clips) in original videos.

Key Features

Fast Search:

Supports locating short audio (highlight clips) in long audio (complete live streams or videos).
A 5-hour video can be processed in about 5 minutes.

Language Unrestricted:

Effective matching regardless of language, speaker, or background noise.

Easy to Use:

Provide the YouTube links for the short clip and the original video.
Input the start and end timestamps of the highlight video to quickly locate its position.

Fault Tolerance:

Even if the highlight video contains some background music or noise, it can still be accurately located.

System Requirements

Hardware Requirements:

At least 2-3GB of available memory.
Disk space depends on the audio length (recommend at least 1GB free space).

Software Requirements:

Python 3.8+.
Some features of this project depend on FFmpeg, and it cannot run without it.

Usage

There are two ways to use this tool:

1. Clone the project locally.
2. Download the executable and run it.

Clone the project locally

1. Install the project
   Clone the project locally:

   git clone https://github.com/JoeYang1412/HighlightLocator.git

2. Install dependencies

   pip install -r requirements.txt

3. Ensure FFmpeg is installed and added to the system path:
   Download FFmpeg:
   https://www.ffmpeg.org/download.html

4. Run the main program
   Launch the main program:

   python main.py

Download the executable

There are two types of executables available:
One is a single file with high portability but slower initial startup (10-20 seconds).
The other includes the runtime environment, where the exe file is within a folder. It has a faster startup (about 5 seconds) but comes as a full folder.

1. For the first option, download HighlightLocator.exe. After downloading, ensure FFmpeg is installed, and you can launch it directly.
2. For the second option, download the HighlightLocator_dist.zip folder. After downloading and extracting it, ensure FFmpeg is installed. Open the HighlightLocator_dist folder, find HighlightLocator.exe, and execute it.

Disclaimer

This tool is for educational and personal use only. Do not use it for commercial or infringing activities.
This project is not responsible for any issues arising from the use of this software.

---

概述

本專案的第一個正式版本提供了一個簡單高效的工具，幫助使用者定位精華影片（短片）在原始影片中的位置。

主要功能

快速查找：

支援定位短音訊（精華片段）在長音訊（完整直播或影片）中的位置。
5 小時的影片僅需約 5 分鐘完成定位。

語言無限制：

無論語言、說話者或背景音雜訊，均可進行高效率的匹配。

操作簡單：

提供短片及原片的 YouTube 連結。
輸入精華影片中的查詢起止時間點，即可快速定位。

容錯處理：

即使精華影片中包含少許背景音樂、雜訊，仍能準確定位。

系統需求

硬體要求：

至少 2-3GB 的可用記憶體。
硬碟空間依音訊長度而定（建議預留 1GB 以上）。

軟體需求：

Python 3.8+。
本專案部分功能依賴 FFmpeg，若缺少將無法執行

使用方法

有兩種方法可以使用

1. clone專案到本地
2. 下載 exe 並執行

直接 clone 專案到本地

1. 安裝專案
   clone 專案到本地：

   git clone https://github.com/JoeYang1412/HighlightLocator.git

2. 安裝依賴

   pip install -r requirements.txt
   

3. 確保安裝 FFmpeg 並已添加至環境變數：
   下載 FFmpeg
   https://www.ffmpeg.org/download.html

4. 執行主程式
   啟動主程式：

   python main.py

下載 exe 來執行

有兩種執行檔可以使用
一種是只有單個檔案，可攜性高，缺點是首次開啟時較慢，可能需要10-20秒
另一種是包含其他執行環境的，exe 被包含在這個資料夾中，啟動速度較快，5秒左右可以開啟，缺點是它是一整個資料夾

1. 若要使用第一種，下載 HighlightLocator.exe 即可，下載完後，確認有安裝 FFmpeg，即可啟動
2. 若要使用第二種，下載 HighlightLocator_dist.zip 這個資料夾，下載完後，解壓縮，並確認你有安裝 FFmpeg，點進 HighlightLocator_dist，找到 HighlightLocator.exe，並執行即可

免責聲明
本工具僅用於教育及個人用途，請勿用於商業或侵權行為。
本專案不對因使用本軟體而產生的任何問題承擔責任。