Frequently Asked Questions

What is Grayjay?

Grayjay is a cutting-edge mobile app that serves as a video player and source aggregator. It allows you to stream and organize videos from various sources, providing a unified platform for your entertainment needs.

What platforms is Grayjay Available on?

Grayjay is currently available on Android, ensuring compatibility with a wide range of smartphones.

Do you have a desktop version?

Yes, the desktop version of Grayjay is available for Linux, Windows & macOS and you can download it heregrayjay.app/desktop/

Are you a streaming service or platform?

No, we are an aggregator to facilitate other streaming platforms. We do not host any content or distribute any content from servers.

Can I change the tabs?

Yes, you can change which tabs are visible, by going to settings and clicking "Manage Tabs".

Where is the subscription tab?

The subscription tab is only visible if you have any subscriptions. It could also be located under More if you changed the tab order.

How do subscriptions work?

When you subscribe to a creator we store the metadata of their channel locally on your device.
Your subscriptions feed is a reverse-chronological list of videos of all creators you subscribed to.
We also show live streams and planned streams at the top.

Can I create playlists and organize my videos in Grayjay?

Yes, Grayjay allows you to create custom playlists and organize your videos based on your preferences. You can easily categorize content, create playlists for different moods or occasions; and manage your video library effortlessly.

Does Grayjay require a subscription?

No, We offer a way to pay for the app once. The app will function identically without paying.

Is there a way to request specific sources or features in Grayjay?

Absolutely! We value user feedback. If you have specific video sources you'd like us to add or features you'd like to see in Grayjay, please reach out to us through the app or our website. We're always keen to enhance your experience based on your suggestions.

Can I see the source code?

Yes, we have a Gitlab repository here: https://gitlab.futo.org/videostreaming/grayjay

Can I create my own source?

Yes, you can write a plugin for Grayjay and allow people to install it.
We keep expanding our documentation which you can find here:
https://gitlab.futo.org/videostreaming/grayjay/-/blob/master/plugin-development.md
https://gitlab.futo.org/videostreaming/grayjay/-/tree/master/docs

How can I report issues or seek assistance with Grayjay?

If you encounter any issues, have questions, or need assistance, our customer support team is here to help. You can contact us via email (grayjay@futo.org), through the app and using the feedback button found in settings.

How do I import Subscriptions from a platform

Go to the sources tab, and click on the platform source you want to import from.
After logging the "Import Subscriptions" button should be available (if the plugin supports it).

How do I import Playlists from a platform

Go to the sources tab, and click on the platform source you want to import from.
After logging the "Import Playlists" button should be available (if the plugin supports it).

How do I import Subscriptions from NewPipe

Export your subscriptions as json in the NewPipe app, then open this json file with Grayjay using the system file browser or a third party file browser.

Why isn't the sync feature working?

If you are experiencing issues with the sync feature, check if a firewall or other security software on your device is blocking traffic on port 12315. This port is necessary for the sync feature to function properly. For now, sync is not able to communicate proxied over the internet but this is a feature that will be implemented soon.