🖥️ About

Welcome to the Boosty Downloader project!

This CLI tool allows you to download most of the content from Boosty.to in bulk. The post content itself is saved in html with a little bit of styling.

You can download:

• Boosty Videos
• External Videos (YouTube, Vimeo)
• Files
• Full Post content (including photos and links)

📑 Table of Contents

• 🖥️ About
  • 📑 Table of Contents
  • ✨ Features
  • 📸 Screenshots & Usage
  • 🛠️ Installation
  • 🚀 Configuration for Usage
    • Step 1: Get the auth cookie and auth header
      • Option 1 - Manually
      • Option 2 - With helper script
    • Step 2: Paste the cookie and auth header into the config file
    • Step 3: Run the utility
  • 💖 Contributing
  • 📜 License

✨ Features

• 📦 Bulk download: Download all available content from your favorite creator.
• 🔎 Total checker: See how many posts are available to you, and which are not.
• 📂 Content type filters: Download only the content you need (videos, images, etc) with --content-type-filter.
• 📄 Download specific posts: Download post by url and username.
• 🔃 Sync content seamlessly: The utility keeps cache of already downloaded posts, so you can resume your download at any time or get new content after a while.
• 📼 Choose your video quality: You can choose preferred video quality to download (for boosty videos)
• 🎨 Beauty posts preview: You can see posts content with rendered offline html files with dark/light theme changing.
• 📊 Order matters: Posts have dates in names, so you can just sort it by name in your file explorer and see them in the correct chronological order.
• 🆙 App update checker: If new updates are available, you'll be notified when you use the application next time.
• 🔑 Auth helper script: Run boosty-downloader show-auth-script to get a browser console script that extracts your credentials automatically.

📸 Screenshots & Usage

🛠️ Installation

1. Install python:

   • Window:

     winget install Python.Python.3.13
     

   • Linux:

     sudo apt-get install python3
     

   • macOS:

     brew install python
     

2. Install the boosty-downloader package:

   pip install boosty-downloader
   

3. Run the application:

   boosty-downloader --help
   

🚀 Configuration for Usage

Step 1: Get the auth cookie and auth header

Option 1 - Manually

1. Open the Boosty website.
2. Click the "Sign in" button and fill you credentials.
3. Navigate to any author you have access to and scroll post a little.
4. Copy auth token and cookie from browser network tab.

Option 2 - With helper script

1. Run boosty-downloader show-auth-script to show the helper script (it will be copied to your clipboard automatically).
2. Open the Boosty website and log in.
3. Open browser console (F12) and paste the script.
4. Scroll the page a little - a floating box with your credentials will appear.

Step 2: Paste the cookie and auth header into the config file

This config will be created during first run of the app in the current working directory.

Step 3: Run the utility

Now you can just download your content with the following command:

boosty-downloader download --username YOUR_CREATOR_NAME

💖 Contributing

If you want to contribute to this project, please see the CONTRIBUTING.md.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.