Welcome to TubeRepair

This guide covers everything on how to set up TubeRepair, and on how to handle error messages.

What TubeRepair works with

TubeRepair works with the old YouTube app (The preinstalled one, from iPhoneOS 3-6.1.6) and the App Store application (Version 1.0-1.0.1 on iOS 4) and version 1.1.0-1.2.1 on iOS 5-10.

(iOS 3-4 does not work, and development on supporting it has not begun)

Uninstall TubeFixer!

It is required for you to uninstall TubeFixer when wanting to use this tweak, as both will interfere and that will cause issues.

You need a Youtube Data API V3 key with TubeRepair

an API key is needed to fetch content from YouTube. If you ever used TubeFixer before, you can just re-use the key that you already have. If not, then creatre an API key.


Download the tweak from Cydia.

The tweak is hosted on my repository. You need to download it from there to begin. (As a prerequisite you should have PreferenceLoader installed too.)

The tweak's name is TubeRepair [BETA]

(iOS 3-4 may not work as of right now)

After you installed the tweak, open settings and go to TubeRepair's preference pane.

You will see a lot of empty fields, those being the server URL endpoint field, API key field, and the API Key Request Header. (Reason why i implemented this is so you could connect to something like TubeFixer with this too (which uses the header X-TubeFixer-API-Key))

First option you should see is this. This is where you input the target URL for your server. You need to specify http/s here, and also depending on your configuration, add a "/" after your folder or link. An example, EXAMPLE would be "http://ax.init.bag-xml.com/TubeRepair/".

An occupied example should look like this

You should inform yourself about available public instances, then use one. There is none I can recommend.

You should be ready now!

Launch the app now and see if it works. The tweak should tell you when it doesn't.

Unlike TubeFixer, depending on what error you encounter, or what you perhaps did wrong in the settings page, the tweak will display an alert when errors occur. Here are all possible error messages you can encounter, and here's how to deal with them.


unsupported URL

Malformed URL, go into settings and fix it. You most likely forgot to append http/s://. If it's still an issue then the server you are trying to connect to is incompatible with TubeRepair.

Error loading
Tap to retry

Can be many things, either no Wi-Fi, serverside issue, or your custom URL being malformed, but the rest of the options being alright. Double check if you speficied "http://" or "https://", and if you added the "/" after TubeRepair. Also check if your app version is between 1.0.0 and 1.2.1, as 1.3+ will not work properly

You reached the end of the guide. I hope everything worked for you.
Enjoy the tweak!