Skip to content

Information about YouTube videos, including channel details, is collected and utilized to generate comprehensive documentation in a docx format.

License

Notifications You must be signed in to change notification settings

PakCyberbot/YouTube-Evidence-Collector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YT Evidence Collector

banner

The purpose of the tool is to gather evidence from YouTube.

ytevidencecollector

ytevidencecollector-webpage

Table of Contents

Installation

Before running the tool, type the following command

pip install -r requirements.txt

Features

  • Downloads YouTube videos
  • Collects data about videos and their channels
  • Collects data about all videos in a channel
  • Takes snapshots of videos/channels in the Wayback Machine
  • Generates a DOCX file with the collected data
[NEW]
  • Ability to download age-restricted videos
  • Bulk video download during channel dump
  • Generates an HTML webpage for improved navigation of dumped channel videos.

Upcoming Features

  • Collect comments for videos
  • Collect additional information about channels such as playlists, community posts, and separate shorts, live streams, and playlists in their own sections in the DOCX file
  • Take screenshots of entire YouTube video/channel pages
  • Implement Google API quota check before channel dump
  • Generate PDF files

Setting Up Your YouTube API Key

  1. Begin by creating your project here.

  2. Next, enable the YouTube Data API by visiting this link.

  3. Create your API key by navigating to API Credentials and clicking on "CREATE CREDENTIALS".

Input Methods for Your API Key

  • You can directly input your API key temporarily through an input box in the GUI or using the -k <apikey> option in CLI mode.

  • Alternatively, you can add your API key to the "yt_apikey" file located in the "libs" folder.

GUI / CLI modes

You can utilize this tool in GUI mode by simply executing it without specifying any arguments.

python YT_evidence_collector.py

CLI Arguments

The tool supports the following command-line arguments:

Argument Description
url URL of the YouTube video or channel url.
-k, --apikey API key for scraping data.
-e, --evidence Enable evidence collection.
-d, --dump Dump the whole channel of the selected video.
-n, --nodownload Disable video downloading.
-w, --wayback Take a snapshot in Wayback Machine.
-b, --bulkvideos Download all channel videos

Example Usage in CLI mode

Here are some examples of how to use the tool with different options:

  1. Download a YouTube video:

    python YT_evidence_collector.py <video/channel url>
  2. Download a YouTube video with API key and Enable evidence collection:

    python YT_evidence_collector.py https://www.youtube.com/watch?v=your_video_id -k your_api_key -e
  3. : Download a YouTube video with evidence collection, if the api key is provided in the file.

    python YT_evidence_collector.py https://www.youtube.com/watch?v=your_video_id -e
  4. Dump the whole channel of the selected video:

    python YT_evidence_collector.py https://www.youtube.com/watch?v=your_video_id -d
  5. Disable video downloading:

    python YT_evidence_collector.py https://www.youtube.com/watch?v=your_video_id -n
  6. Take a snapshot in Wayback Machine:

    python YT_evidence_collector.py https://www.youtube.com/watch?v=your_video_id -w

Disclaimer:

This tool, the YouTube Evidence Collector, is intended for educational, research, and investigative purposes only. It is not to be used for any illegal activities. Users are responsible for ensuring compliance with all applicable laws and regulations. The creator of this tool does not condone misuse or unauthorized use. By using this tool, you agree to use it responsibly and hold harmless the creators from any liability.

About

Information about YouTube videos, including channel details, is collected and utilized to generate comprehensive documentation in a docx format.

Resources

License

Stars

Watchers

Forks

Packages

No packages published