Windows install instructions

This guide explains the setup steps necessary to run the BitcasaFileFetcher on windows it is current as of version 0.7. Throughout this guide I am using powershell simply because it is more convenient. It is recommended to run powershell as an administrator while installing but it may not be necessary. These instructions should also work in command prompt. I had issues using pip modules in cygwin so I wouldn't recommend using it unless you know what you are doing.

Installing python

• First you need python. To check if python is already installed simply open powershell and type python --version. This should output Python 2.7.x (the value of x doesn't matter)
• If this outputs Python 3.x.x then continue bellow to install 2.7 (NOTE: In some cases to find this out check the installed programs listing)
• If you do not have python installed, install it from their website using the proper MSI installer. This is usually Windows x86 MSI Installer (2.7.x). Use the Windows x86-64 MSI for x64 support.
• Once installed, open up powershell and type python --version to verify it worked. (Troubleshooting python is beyond the scope of this tutorial)

Installing pip (no longer needed)

• pip was previously needed to install dependencies. Those dependencies are now included for you, but here is the minimal guide anyway.

Running the App

• After successfully installing python you can now easily download and upload stuff nsuch
• First, Download the current stable
• Unzip it to a directory of your preference
• Open powershell and cd to that directory. For example:

     cd C:\Users\<user>\Downloads\BitcasaFileLister-0.x

• In order to get your Bitcasa credentials you need to oauth using the BitcasaFileLister do so using the following command

     python BitcasaFileLister

• This will run a local server, and open a browser to take you there for authentication
• Click Login to authorize access via Bitcasa oAuth
• Upon successful login you should see a message that your token was stored
• At this point, your token will be stored and you can view your files and get the base64 path
• To get the Base64 file paths click view files
• For downloading content you will need the base64 path from second column
• Return to powershell and hit CTRL+C
• To oauth with Google Drive (if you plan to upload) use the following syntax

     python BitcasaFileFetcher oauth --provider gdrive

• This command should open a browser for you to oauth with google drive and redirect you to a screen with your token
• Copy that token and paste it into powershell by right-clicking
• Your done!
• Important Be sure to test the file fetcher using a single level directory containing a small number of files. As of version 0.7.1 You can also run using the --dryrun param to simply check what files need to be uploaded/downloaded

Specifying folders:

• In windows, folders should be specified using quotations. For example:

"C:\Users\rxsegrxup\Downloads\some stuff"

• It is important in windows to leave out trailing slashes:

INCORRECT

"C:\Users\rxsegrxup\Downloads\some stuff\"

• Relative folders can also be used; the current location is referenced by a single period

"."

• This is useful if, for example, you want all of the log files stored with the BitcasaFileFetcher application

python BitcasaFileFetcher download BASE64PATH DESTINATION -t ".\logs"

• However, you can also omit this period, and it will still be relative but a bit less specific

python BitcasaFileFetcher download BASE64PATH DESTINATION -t logs

• As you may notice above, there are no quotes around logs. Technically, quotes are only necessary when referencing paths with special characters and spaces. However, it is better to get in the habit of using them all the time. Better safe than sorry

Examples

• For example commands please see the README