Skip to content

Latest commit

 

History

History
120 lines (81 loc) · 4.21 KB

README.rst

File metadata and controls

120 lines (81 loc) · 4.21 KB

pibooth-dropbox

Python 3.6+ PyPi package PyPi downloads

pibooth-dropbox is a plugin for the pibooth application.

Its permits to upload the pictures to a Dropbox folder. It requires an internet connection.

Install

$ pip3 install pibooth-dropbox

Configuration

Here below the new configuration options available in the pibooth configuration. The keys and their default values are automatically added to your configuration after first pibooth restart.

[DROPBOX]

# Dropbox folder where pictures are uploaded. Subfolders can be separated by /
album_name = Pibooth

# Dropbox Application Key
app_key =

# Dropbox Application Password
app_secret =

Note

Edit the configuration by running the command pibooth --config.

Picture URL

Uploaded picture URL is set to app.previous_picture_url attribute at the end of processing state (state_processing_exit hook).

Warning

for security reason, URL will expire in 4 hours.

Grant secured access

Access to a Dropbox is granted by an APP_KEY and an APP_SECRET that shall be defined in the configuration. These are not your Dropbox credentials and it can not be used by an other application than the one defined in Dropbox.com.

step1_create_button Go to Dropbox App Console and click on the Create app button.
step2_project_name Under Choose an API section, select Scoped Access. Under Choose the type of access you need, select Full Dropbox. Enter an application name (for instance My Awsome Photo Booth).
step3_app_key Click the Create app button. You will be redirected to the console for your app. Note the presence of your App key and App secret on this page. You will need to enter these into pibooth configuration file once you have followed the remaining steps.
step4_redirect_uri Add the OAuth Redirect URI http://localhost:35880/ to your Dropbox app settings under the OAuth2 Redirect URIs section.
step5_permissions Click on the Permissions tab then select the files.content.write and files.content.read permissions in order to allow pibooth to upload pictures on your Dropbox. Finally click the Submit button at the bottom of the page for the new permissions to take effect.

Note

At the first connection, allow pibooth to use Dropbox in the opened web browser window.