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.
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.
curl https://raw.githubusercontent.com/nickheyer/DiscoClip/main/installer/auto_install_update.sh -o auto_install_update.sh && sudo bash auto_install_update.sh
docker image pull nickheyer/discoclip:latest
docker image pull nickheyer/discoclip_rpi:latest
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
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.
- Python - Download and install Python here. Make sure that you choose "Add Python to environmental variables" during installation.
- Git - Download and install Git here
- FFMpeg - Download and install FFMpeg here.
- "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
.
- Change directory to preferred install location
cd /where/you/want/this/installed
- Clone DiscoClip
git clone https://github.com/nickheyer/DiscoClip
- Change directory to DiscoClip
cd ./DiscoClip
- Install "requirements.txt"
pip install -r requirements.txt
- Run DiscoClip
sh ./run.sh
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!
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.
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.
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.
Type the following into a discord chat message that the bot can see:
!dc test
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/
- For any other comments or questions, feel free to reach me on discord via NicholasHeyer#4212
- Feel free to join the Discord!
Contributions are always welcome!
Email [email protected]
for ways to get started.