This program is a command line client to access OVH hubic API and a wrapper for the swift client.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This program is a command line client for OVH hubiC API and a wrapper for swift client.

This program is not developed, nor maintained by OVH. Use at your own risk!


This is program is written in python and has only been tested on debian wheezy. It relies on a few python libraries (requests, ...). Please check header for the complete list.

The following packages should be enough to make it work on Ubuntu 14.04 apt-get install python-swift python-requests or using pip pip install -r requirements.txt

You must register an application in your hubiC account to access the hubiC API.

You will need a valid client_id, client_secret and redirect_uri.

redirect_uri can be any url accepted by OVH. This program does not actually perform any connection to this url. If you don't know, use:



How to use video

How to use video

Get complete function list

$ ./ --help

Request a new access token

$ ./ --token will load and store for hubiC credentials in the default config file $HOME/.hubic.cfg unless otherwise specified.

$ ./ --config my_hubic_config
$ cat ~/.hubic.cfg
client_id = api_hubic_4b1dee31565ff182f98a05882fffbc8e
client_secret = 95f642cfce603f2430c23a4106ce8ea55d85a972
redirect_uri = http://localhost/
username = my_hubic
password = my_hubic_password
os_auth_token = ba8fb42dd1d7d3a5e3194d146cc9d699fd700ff2
os_storage_url =

If not provided as environment variables or as command line arguments, the program will request application and user credentials :


Please use the above variable names but replace values with your own credentials. will then perform all authentification steps. If succeed, you will get your own access and refresh token to the hubiC API.


Request a new access token

Access token have a limited lifetime. You can get a new access token with your refresh token:

$ ./ --refresh

Request hubiC API

The complete list of hubiC API is available here

To access hubiC API, just specify the type of request (--get, --post, --delete) followed by the hubiC API name :

$ ./ --get /account

If you want to perform a POST request, you can add URL encoded data with the "--data" option (See

$ ./ --post /account/links --data "comment=none&container=default&mode=ro&ttl=1&type=file&uri=%2Fmyshare.txt"

Display currently used environment variables

This is useful if you encounter auth issues.

$ ./ -v

Use the swift client to access hubiC OpenStack

This program can act as a proxy to swift client.

$ ./ --swift -- list default

All parameters provided after "--" are forwarded to swift client. If OS_AUTH_TOKEN and OS_STORAGE_URL are not already provided in the environment, the program will request them using "/account/credentials" API

Python 3 compatibility script is not compatible with python 3, use instead.


Please report any bug or enhancement requests to the github project page


This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see