Skip to content

An archival server/bot that monitors discord channels for IG/TikTok video-links then downloads, transcodes (to Discord's size limit), and posts the video to the same channel.

License

Notifications You must be signed in to change notification settings

nickheyer/DiscoClip

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

image

DiscoClip

A web-app/bot that monitors discord channels for IG/TikTok video-links then downloads, transcodes (to Discord's size limit), posts, and archives each video.


General Requirements

Running the discord bot requires a discord developer account (https://discord.com/developers/applications), and a bot created/invited (via your developer acount) to your chosen discord server.

Installation (Recommended Method)

Linux -- Fully Automated Install & Updates

curl https://raw.githubusercontent.com/nickheyer/DiscoClip/main/installer/auto_install_update.sh -o auto_install_update.sh && sudo bash auto_install_update.sh

Other Operating Systems (Windows/Mac) or (Manual Docker Installation)

Download Docker Image (x86_64 Architecture)
docker image pull nickheyer/discoclip:latest
Download Docker Image (aarch64 Architecture, ie: Raspberry-Pi)
docker image pull nickheyer/discoclip_rpi:latest
Run Docker Container
docker run -d -p 7600:7600 nickheyer/discoclip
The server within the docker container can be accessed locally at http://127.0.0.1:7600

Installation From Source (Not Recommended)

Prerequisites, Dependencies, and Requirements

NOTE: Installation from source using Windows has been deprecated with the introduction of web-socket functionality, gevent, and other integral parts of this application that are not currently supported by Microsoft.

  1. Python - Download and install Python here. Make sure that you choose "Add Python to environmental variables" during installation.
  2. Git - Download and install Git here
  3. FFMpeg - Download and install FFMpeg here.
  4. "requirements.txt" - Once you've git-cloned DiscoClip (see next steps), you will be instructed to install the remaining dependencies found in this file, via pip install -r requirements.txt.

Next Steps

  1. Change directory to preferred install location
cd /where/you/want/this/installed
  1. Clone DiscoClip
git clone https://github.com/nickheyer/DiscoClip
  1. Change directory to DiscoClip
cd ./DiscoClip
  1. Install "requirements.txt"
pip install -r requirements.txt
  1. Run DiscoClip
sh ./run.sh

General Instructions

Accessing The Web-UI

image

If you are running DiscoClip on the machine you would like to access it from, you should be able to access it here. Otherwise, you will need to get the IP address of the computer hosting DiscoClip. On Windows, you would type ipconfig on the host machine and look for your ipv4.

If you would like to access DiscoClip remotely, as in not on the same network as the host machine, you will need to do some port forwarding to expose port 7600 to the internet. If you run into any trouble here, feel free to join the Discord!


Configuration

image

DiscoClip is mostly good to go in terms of configuration. The only thing you will need to provide it is a token from Discord. The bot will not start without a valid token. Once your bot is made, you can get the token by clicking 'Reset Token' which will provide it one time only.


image

If you haven't already, now is also a good time to invite the bot to the server or servers you would like to monitor, you can do that via the same link.


image image

Make sure you select these intents and permissions on your bot page and while generating your invite link (via url generator). It doesn't need to have administrator permissions, that is up to you. Just make sure that it can read and write messages, etc.


Usage

Test That The Bot Is Running

Type the following into a discord chat message that the bot can see:

!dc test

Your First Clip

Test that the bot is archiving, transcoding, and storing video files properly by pasting a TikTok or Instagram Video url into chat. You can give it a shot with one of my TikTok videos!

Normally, you would not be able to save and upload a video of this size to Discord, but now you can with DiscoClip's transcoding magic! Just paste this link into chat:

https://www.tiktok.com/t/ZTRsaDRqY/

Further Notes

  • For any other comments or questions, feel free to reach me on discord via NicholasHeyer#4212
  • Feel free to join the Discord!

Authors

Contributing

Contributions are always welcome!

Email nick@heyer.app for ways to get started.

About

An archival server/bot that monitors discord channels for IG/TikTok video-links then downloads, transcodes (to Discord's size limit), and posts the video to the same channel.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published