name	author	version	source	home	icon
youtube-wrapped	[email protected]	1.0.0	https://github.com/madhavajay/youtube-wrapped	https://syftbox.net/datasites/[email protected]/youtube-wrapped/index.html	https://raw.githubusercontent.com/madhavajay/youtube-wrapped/refs/heads/main/icon.png

🎬 YouTube Wrapped

1-liner Install

Installs SyftBox + youtube-wrapped on MacOS and Linux:

curl -fsSL https://syftbox.net/install.sh | sh -s -- --apps=https://github.com/madhavajay/youtube-wrapped/

Start the client now? [y/n] y

SyftBox can assign a random port so look for something like this:

2025-05-20T13:13:16.848+10:00 INF app started app=youtube-wrapped url=http://localhost:53214

Your Watch History, Your Insights, Your Data.

Tired of platforms hoarding your viewing habits without giving anything back? YouTube Wrapped is like Spotify Wrapped—but for YouTube, and fully under your control.

Just drop in your exported YouTube history and get a beautiful, private summary of your top videos, creators, and moments.

Then, compare your wrapped with friends to see who’s binging what. Want more? Get personalized recommendations powered by open-source AI, based on your actual taste—not what the algorithm wants you to watch.

Tell me you're a parent, without telling me you're a parent

What is SyftBox?

SyftBox is a new platform for building privacy-preserving applications and experiences that work over the internet without uploading your data. Instead of sending your data to a server, SyftBox lets you run powerful AI and analytics locally or in trusted environments, so your personal information stays private and secure.

Read more about SyftBox here

Installation Steps

To get started with youtube-wrapped, follow these steps:

1. Install SyftBox:
   First, you need to install Syft Box. You can find the installation instructions at the following link:
   Install SyftBox

   curl -fsSL https://syftbox.net/install.sh | sh

2. Install the youtube-wrapped app:
   Once Syft Box is installed, you can install the youtube-wrapped app using the following command:

   syftbox app install https://github.com/madhavajay/youtube-wrapped

3. Load the UI:
   NOTE: the port is random on the newer syftbox.
   After installing the youtube-wrapped app, you can load the user interface by clicking http://localhost:8080 in your web browser. This will allow you to interact with the app and explore its features.

   

4. Follow the Wizard:
   The wizard will guide you through the process of obtaining your data from Google Takeout, acquiring a YouTube API v3 key, and enriching your data for comprehensive analysis. This step-by-step process ensures you have all the necessary components to make the most out of your YouTube Wrapped experience.

Dev Mode

To play around you can kill syftbox and run ./run.sh from the source directory and then you'll get the default port listed in run.sh.

SYFTBOX_ASSIGNED_PORT=${SYFTBOX_ASSIGNED_PORT:-8080}

http://localhost:8080