Grayjay Subscriptions Exporter Scripts

Python scripts to export Grayjay app subscriptions for backup or import into NewPipe-compatible applications.

---

grayjay2freetube

This script converts Grayjay subscriptions and subscription groups into a format compatible with FreeTube.

If only the Grayjay app directory is provided the configuration is printed to stdout.

WARNING: This script overwrites the current FreeTube subscription configuration if the FreeTube directory is provided.

Features

• Converts Grayjay subscription JSON files to FreeTube profiles.db.
• Includes all subscriptions and subscription groups.
• If the second argument (FREETUBE_PATH) is omitted, the script prints the converted data to stdout and does not modify any files.
• If the second argument is provided, the script creates a backup of the existing profiles.db in the format profiles.db.<timestamp>.bak before overwriting it.

Usage

grayjay2freetube  <grayjay_directory> [freetube_configuration_directory]

Linux example (print to stdout):

grayjay2freetube "/opt/GrayjayDesktop"

Linux example (update FreeTube subscriptions):

grayjay2freetube "/opt/GrayjayDesktop" "/home/user/.config/FreeTube"

---

grayjay2json

This script converts Grayjay subscriptions and groups into a generic JSON format.

The JSON string is printed to stdout.

Features

• Converts Grayjay subscription JSON files to NewPipe-compatible JSON format.
• Optionally includes Grayjay group files in the output.
• Outputs a structured JSON object with subscriptions and, if provided, groups.

Usage

grayjay2json  <subscription_directory> [groups_directory]

Linux example (subscriptions only):

grayjay2json "/opt/GrayjayDesktop/subscriptions"

Linux example (subscriptions & groups):

grayjay2json "/opt/GrayjayDesktop/subscriptions" "/opt/GrayjayDesktop/subscription_groups"

---

grayjay2newpipe

This script converts Grayjay subscriptions into a format compatible with NewPipe. The NewPipe JSON format does not support subscription groups, so group information is omitted.

The JSON string is printed to stdout.

Features

• Converts Grayjay subscription JSON files to NewPipe-compatible JSON format.

Usage

grayjay2newpipe <subscription_directory>

Linux example:

grayjay2newpipe "/opt/GrayjayDesktop/subsriptions"