Skip to content

v1.0.0
Compare
Choose a tag to compare
@JoeYang1412 JoeYang1412 released this 23 Jan 13:25
· 4 commits to main since this release
v1.0.0
5954dc0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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，並執行即可

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

Assets 5
Loading