dropbox-api-command

dropbox-api-commandのdropbox-apiとは、FreeBSDでクラウドサービスDropboxにアクセスするためのコマンドです。コマンドを使用して、Dropboxのファイルの更新や参照ができます。

読み方

dropbox-api-command: どろっぷぼっくす　えーぴーあいこまんど

概要

Dropboxを利用して、Windows, Mac, Linux などでファイルを共有でき、複数の環境を併用している方には、設定ファイルを同期できる仕組みは、大変便利なものです。zshやvimなどの設定ファイルをいくつものシステムで共有するときに、クラウドサービスは便利です。

インストール

pkgコマンドでインストールする場合

sudo pkg install dropbox-api-command

セットアップ

API KeyとSecretの取得

まず、Dropbox のサイトで、自分のアプリケーションを作成し、API Key, API Secret を手に入れます。登録は、以下のサイトでできます。

https://www.dropbox.com/developers/apps

Full DropboxのPermissionでKeyを作成する必要があります。 API Key作成時の設定は、以下の通りです。

Dropbox API app
Files and datastores
No - My app needs access to files already on Dropbox
All file types My app needs access to a user's full Dropbox. Only supported via the Core API.

API KeyとSecretの登録

取得したAPI Key, Secret を dropbox-api のコマンドの設定ファイルに登録します。

$ dropbox-api setup
Please Input API Key: XXXX
Please Input API Secret: XXXX
Please Input Access type
  a ... App folder - Your app only needs access to a single folder within the user's Dropbox
  f ... Full Dropbox - Your app needs access to the user's entire Dropbox
[a or f]: f
URL: https://www.dropbox.com/1/oauth/authorize?oauth_token=XXXX&oauth_callback=
Please Access URL and press Enter
OK?y
success! try
> dropbox-api ls
> dropbox-api find /

設定

設定は、 ~/.dropbox-api-config に作成されます。

使い方

コマンドラインオプション

Usage: dropbox-api <command> [args] [options]
 
Available commands:
    setup get access_key and access_secret
    ls    list directory contents
    find  walk a file hierarchy
    cp    copy file or directory
    mv    move file or directory
    mkdir make directory (Create intermediate directories as required)
    rm    remove file or directory (Attempt to remove the file hierarchy rooted in each file argument)
    put   upload file
    get   download file
    sync  sync directory (local => dropbox or dropbox => local)
    uid   get accound uid
 
Common Options
    -e enable env_proxy ( HTTP_PROXY, NO_PROXY )
    -D enable debug
 
See 'dropbox-api help <command>' for more information on a specific command.

dropbox からローカルに指定したディレクトリを同期する

$ cd
$ mkdir -p Dropbox
$ cd Dropbox
$ dropbox-api sync dropbox:/dotfiles .
download /home/foo/Dropbox/.gitconfig
download /home/foo/Dropbox/.gitignore
download /home/foo/Dropbox/.gvimrc
download /home/foo/Dropbox/.tmux.conf
download /home/foo/Dropbox/.vimrc
download /home/foo/Dropbox/.zshrc

dropbox からローカルから指定したディレクトリを同期する

$ dropbox-api sync dotfiles dropbox:/

任意のファイルをDropboxにアップロードする

dropbox-api put ~/.vimrc	dropbox:/dotfiles/
dropbox-api put ~/.zshrc	dropbox:/dotfiles/
dropbox-api put ~/.bashrc	dropbox:/dotfiles/
dropbox-api put ~/.cshrc	dropbox:/dotfiles/
dropbox-api put ~/.tmux.conf	dropbox:/dotfiles/

任意のファイルをDropboxからダウンロードする

dropbox-api get dropbox:/dotfiles/.vimrc	~/
dropbox-api get dropbox:/dotfiles/.zshrc	~/
dropbox-api get dropbox:/dotfiles/.bashrc	~/
dropbox-api get dropbox:/dotfiles/.cshrc	~/
dropbox-api get dropbox:/dotfiles/.tmux.conf	~/

Public フォルダにアップロードする

Public フォルダにアップロードする専用のコマンドがあります。

$ upload-to-dropbox some.txt

上記は、以下のコマンドと同じです。

$ dropbox-api upload /tmp/local.txt dropbox:/Public/some.txt

Dropbox で設定ファイルを共有する

$HOME/Dropbox/dotfiles に設定ファイルを入れている前提です。

#!/bin/sh
for f in .zshrc .zsh .vimrc .vim .gvimrc .tmux.conf .screenrc \
	.gitconfig .gitignore .bashrc .cshrc .emacs .emacs.d
do
	ln -s $HOME/Dropbox/dotfiles/$file $HOME/$file
done