Clip Forge

How to Use Clip Forge (For Absolute Beginners) 🛠️

You don't need any coding experience to learn this! Just follow these straightforward steps to create your first video:

Step 1: Install Docker

Docker is like a safe "virtual box" that runs Clip Forge without changing your computer's settings.

• Download and Install Docker Here

Step 2: Install uv

uv is a simple tool that automatically prepares the project for you behind the scenes.

• Download and Install uv Here

Step 3: Download Clip Forge

Go to our GitHub page, click the green "Code" button, and select "Download ZIP". Double-click the ZIP file to extract it to a folder you can easily find (like your Desktop).

• Get the Project Code on GitHub

Step 4: Get Reddit API Secrets

Clip Forge needs a special "key" to fetch stories from Reddit. It's totally free!

1. Go to the Reddit Apps settings page and log in.
2. Click "Create App" or "Create Another App..." at the bottom.
3. Give it a name, select "script", and put http://localhost:8080 in the "redirect uri" box.
4. Click "Create app". You will now see your Client ID (under the name) and Client Secret. Keep these safe!

Step 5: Fill Out the Setup File

Open the folder you downloaded in Step 3. You will find a file called setup.yml (or example.setup.yml which you should rename to setup.yml). Open it with Notepad!

Find the Reddit section inside and paste the Client ID and Client Secret from Step 4. You can also add your Discord webhook if you want alerts!

Step 6: Run the Magic Command! 🎉

Pro-Tip for Beginners: Open the shorts_maker folder you downloaded, right-click anywhere in the empty space, and click "Open in Terminal".

Once the black box opens, simply type this and press Enter:

uv run example.py

Your computer will automatically download everything it needs and start creating your video! Wait patiently for it to finish setting things up.

What's Next? 👀

When the screen stops printing text, look inside the assets folder. You will find your finished video, ready to upload!