https://github.com/nickheyer/discoclip
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.
https://github.com/nickheyer/discoclip
discord instagram instagram-scraper tiktok tiktok-downloader tiktok-scraper
Last synced: 7 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/nickheyer/discoclip
- Owner: nickheyer
- License: mit
- Created: 2023-01-28T20:54:56.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-27T21:52:41.000Z (about 2 years ago)
- Last Synced: 2023-08-27T22:34:52.575Z (about 2 years ago)
- Topics: discord, instagram, instagram-scraper, tiktok, tiktok-downloader, tiktok-scraper
- Language: Python
- Homepage:
- Size: 92.8 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
```bash
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)
```bash
docker image pull nickheyer/discoclip:latest
```
##### Download Docker Image (aarch64 Architecture, ie: Raspberry-Pi)
```bash
docker image pull nickheyer/discoclip_rpi:latest
```
##### Run Docker Container
```bash
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](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](https://www.python.org/downloads/). Make sure that you choose "Add Python to environmental variables" during installation.
2. Git - Download and install Git [here](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
3. FFMpeg - Download and install FFMpeg [here](https://ffmpeg.org/download.html).
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
```bash
cd /where/you/want/this/installed
```
2. Clone DiscoClip
```bash
git clone https://github.com/nickheyer/DiscoClip
```
3. Change directory to DiscoClip
```bash
cd ./DiscoClip
```
4. Install "requirements.txt"
```bash
pip install -r requirements.txt
```
5. Run DiscoClip
```bash
sh ./run.sh
```
## General Instructions
#### Accessing The Web-UI
#### *If you are running DiscoClip on the machine you would like to access it from, you should be able to access it [here](http://127.0.0.1:7600). 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](https://discord.com/invite/6Z9yKTbsrP)!*
### Configuration
#### *DiscoClip is mostly good to go in terms of configuration. The only thing you will need to provide it is a token from [Discord](https://discord.com/developers/applications). 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.*
## 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](https://discord.com/invite/6Z9yKTbsrP)!
## Authors
- [@nickheyer](https://www.github.com/nickheyer)
## Contributing
Contributions are always welcome!
Email `nick@heyer.app` for ways to get started.