View source for YouTube Bulk Uploader for the Lazy Troubleshooting Guide

This page covers some common issues you may face when using the software. If you are experiencing any issues (Quite commonly these are permission issues), then please review this Wiki page before attempting to contact us.

== How to use the Software ==
We have provided many videos on how to operate the software with some added advice and tips thrown in too! You can either watch a video which covers each aspect of the software, or view the quick product demonstration. If you have any issues, problem or queries, please view the remainder of this page or contact us [https://ginkosolutions.com/youtube-bulk-uploader/]

* https://www.youtube.com/watch?v=60RM35CfP_0&list=PLJitdQVsSaf69nbFf59_ZwraITSMBtLZi - Full Software Video Playlist
* https://youtu.be/-vUzqPKcssQ - Full Software Demonstration
* https://youtu.be/60RM35CfP_0 - Quick Software Demonstration
* https://youtu.be/6B9xtbSn-_U - Account/Channel Management
* https://youtu.be/b5aglSYQ9no - Video Editor
* https://youtu.be/0ZveB7FWikA - Video Database
* https://youtu.be/m8CXKy_8JI0 - Tag Manager
* https://youtu.be/WbNKFe2TIuQ - Upload Queue
* https://youtu.be/XAOVfcb3wuo - File Path Sync

== Adding YouTube Channels ==

'''Symptom''': Web Browser window pops up but doesn't present YouTube login screen. A message such as "This webpage is not available" may appear.

'''Solution''': 
This screen presents itself when the software cannot communicate with Google to authorize the application. This is typically due to network configuration or firewall settings.

You will need to allow access via the following ports to the following services in order to use this software:


Host: www.googleapis.com

Ports: 80 and 443 (HTTP and HTTPS)


Host: accounts.google.com

Ports: 80 and 443 (HTTP and HTTPS)


Host: www.ginkosolutions.com

Port: 80 and 443 (HTTP and HTTPS)


Host: www.ginkosolutions.com

Port: 80 and 443 (HTTP and HTTPS)


Host: checkip.dyndns.org

Port: 80 and 443 (HTTP and HTTPS)

== Adding Videos to the Software ==

'''Symptom''': A message appears stating: "The name is not valid. (Exception from HRESULT: 0x800300FC (STG_E_INVALIDNAME))". This can also happen when using the File Path Sync and Database Sync utilities.

'''Solution 1''':
This message appears when one of the required prerequisites has not been installed correctly. Please follow the included ReadMe file with the software and perform all installation steps.

'''Solution 2''':
Files cannot be accessed with the current user permissions. Elevate your user privileges on your local computer. A good test would be to run the software as an Administrative User and retry.

'''Solution 3''':
File is located on a network drive, USB drive or other removable storage without required permissions. Check your user access privileges and make sure the current user is able to access the video files.

'''Solution 4''':
File is location in a directory which is too long. Move the file on your local system so that the total file path length is shorter.


'''Symptom''': Cannot drag and drop videos onto the application window. Mouse icon changes to a 'no access' symbol.

'''Solution''':
This is a security issue with your local computer. It is called UIPI, User Interface Privilege Isolation [https://msdn.microsoft.com/en-us/library/bb625963.aspx]

The source and target processes need to have compatible security levels/privileges. For example, if your source is Explorer and it is running with user level privileges, but your target application is running with administrator (elevated) level permission, you will not be able to drag & drop as this is seen as a security issue as the target is running with a higher level of privileges.

Designed to prevent input injection exploits from programs that run with restricted privileges.

You can try the following:
- Store this software in a subdirectory of c:\windows or c:\program files
or
- Running the program as a non-administrative user
or
- Turning off User Interface Privilege Isolation [https://msdn.microsoft.com/en-us/library/bb625963.aspx]

== Uploading Videos ==

'''Symptoms''': Video upload error: 'Upload Error Value cannot be null. Parameter name: baseUri'

'''Symptoms''': Upload Error: Error:"unauthorized_client", Description:"Unauthorized", Uri:""

'''Symptoms''': Video progress is stuck on 'Starting...'

'''Solution 1''':
You have added a new account to the software, however, the authorization/OAuth process did not complete successfully. When adding a new account, or when attempting to upload a video from an account that has not yet been authorized, you must allow the software permission to upload to the YouTube account. If you do not allow permission, the upload will remain at the 'Starting...' status while it waits for required approval.

When providing the software permission, your default browser will automatically open and re-direct to YouTube. Make sure that the correct account is logged in when providing software permissions. If the default browser window does not open, please make sure your DEFAULT web browser is working correctly.

If you have managed to upload videos before, then the above error appears, then the authorization link between the YouTube account and this software may have severed. This can happen when removing the settings files used by the software to store this authorization process from your local computer (Invasive software such as CCleaner may have done this). This can also happen if an issue arose with the YouTube account itself (Restricted, banned, limited etc).

If this error reoccurs, then the software may not have permission to store these changes on your computer for next time. If this is the case, try running the software as an Administrative user so that he software can store these authorization/OAuth permissions.

If the above steps have been taken, try manually uploading a video to YouTube with the same account. Use your default web browser to ensure that the same YouTube account is being used by the software and to test a manual upload process.

If all else fails, try adding a new account to the software (with a different account name/label), but using the same YouTube account during the authorization/OAuth process.

'''Solution 2''':
This message appears in software version 2.4 and lower IF the video description is too long. This is because when wildcard tags are replaced, the video description can exceed 5000 characters. Please shorten the video description and try again.


'''Symptoms''': The upload progress bar displays no progress.

'''Solution''':
Your videos may be smaller in physical file size than the video Upload Chunk Size.
Within the settings for the application, you will notice a field named: Upload Chunk Size (KB). This value indicates how your video is uploaded to YouTube. The progress bar only updates when a "chunk" of the video has been uploaded. I.e. If you are uploading a 10MB video with a 20MB Chunk Size, you will see no progress or updates. However, the video will upload and the status will change to Completed when the video is uploaded.


'''Symptoms''': Generic problems uploading videos

'''Solution 1''':
You may have added videos to the upload queue, then while sitting in the queue, you have manually removed or renamed the physical video files.

'''Solution 2''':
You have created a new YouTube account and have yet to enable the account for video uploading. When creating a new YouTube account via the website, you MUST set up a channel within the account. This software communicates with video channels, and without a channel, the software cannot upload.


'''Symptoms''': Backend Error [500] Errors Message Backend Error - Reason backend. Error Domain: global

'''Solution 1''':
99% of the time, this is typically a problem with the YouTube API. Google/YouTube have been doing things (Updates etc) behind the scenes and there is temporary downtime. Please wait 1-24 hours before re-uploading.

'''Solution 2''':
Go to the Upload Queue and remove the failed videos from the list. Go to the Video Database, find the video, and add it back to the Upload Queue. If you do not have the video in the Video Database, just re-add the video into the software. Now re-try the upload. You may wish to visit your channel in a web browser and delete the failed video.


'''Symptoms''': Backend Error [503] Errors Message Backend Error - Reason backend. Error Domain: global

'''Solution 1''':
This error will present itself when you have reached your daily upload limit for your channel and/or channel. This limit is imposed by YouTube. Our software has no control over this limit.

'''Solution 2''':
This error may present itself when Google has been fiddling with the YouTube API (This can and does happen; albeit rare) and is unfortunately out of our control. Retry the video upload process at a later time (24 hours or so). If the problem re-occurs, please remove the video from the upload queue and use the Video Database to re-add the video to the upload queue. If you do not have the video in the Video Database, just re-add the video into the software and re-upload.

'''Solution 3''':
Optionally, you can create your own API interface with YouTube if you wish to do so. This will give you the flexibility of being solely responsible for the content you wish to upload to YouTube and may provide an alternative maintenance schedule. From software version 4.0 and on wards, please refer to the included document entitled: "API Usage.txt" which is bundled with the software. Alternatively, you can read this information here: [[Create API Interface]]. PLEASE NOTE: Creating your own API interface is entirely optional and we do not provide support for this as we need to keep our support lines open for software issues only. Any such support requests will be removed and deleted.


'''Symptoms''': Upload Error: Upload Service Temporarily Unavailable

'''Solution 1''':
This can occur when a very large video is uploaded. Ensure your video meets YouTube's length and size parameters. If it does, and the error persists, then remove the video from the upload queue completely, re-add the video and re-upload. This can happen if the video failed previously due to connection issues and the inbuilt-auto resume cannot resume the video. This is a known YouTube API issue, but it happens rarely.


'''Symptoms''': Response status code does not indicate success: 403 (Forbidden).

'''Solution 1''':
This error may present itself when Google has been fiddling with the YouTube API (This can and does happen; albeit rare) and is unfortunately out of our control. Retry the video upload process at a later time (24 hours or so). If the problem re-occurs, please remove the video from the upload queue and use the Video Database to re-add the video to the upload queue. If you do not have the video in the Video Database, just re-add the video into the software and re-upload.

'''Solution 2''':
Optionally, you can create your own API interface with YouTube if you wish to do so. This will give you the flexibility of being solely responsible for the content you wish to upload to YouTube and may provide an alternative maintenance schedule. From software version 4.0 and on wards, please refer to the included document entitled: "API Usage.txt" which is bundled with the software. Alternatively, you can read this information here: [[Create API Interface]]. PLEASE NOTE: Creating your own API interface is entirely optional and we do not provide support for this as we need to keep our support lines open for software issues only. Any such support requests will be removed and deleted.

== Contact Us ==
If your problem, issue or query is not listed here, please feel free to contact us via the product website here: https://ginkosolutions.com/youtube-bulk-uploader/ [https://ginkosolutions.com/youtube-bulk-uploader/]