Skip to content

Latest commit

 

History

History
126 lines (93 loc) · 3.75 KB

README.md

File metadata and controls

126 lines (93 loc) · 3.75 KB

pCloud Console Client

This is a simple linux console client for pCloud Cloud Storage.

Requirements

  • Zlib A Massively Spiffy Yet Delicately Unobtrusive Compression Library
  • Boost Boost system and boost program options libraries used
  • Pthread
  • Fuse Filesystem in Userspace

Also requires CMake build system.

On Ubuntu you can run the following command to install them.

sudo apt-get install cmake zlib1g-dev libboost-system-dev libboost-program-options-dev libpthread-stubs0-dev libfuse-dev libudev-dev

Build steps

sudo apt-get install git cmake zlib1g-dev libboost-system-dev libboost-program-options-dev libpthread-stubs0-dev libfuse-dev libudev-dev
mkdir console-client
git clone https://github.com/pcloudcom/console-client.git ./console-client/
cd ./console-client/pCloudCC/
cd lib/pclsync/
make clean
make fs
cd ../mbedtls/
cmake .
make clean
make
cd ../../
cmake .
make
sudo make install
ldconfig
pcloudcc -u username -p

Usage

Terminal command is pcloudcc and -h option prints short options description.

./pcloudcc -h  
pCloud console client v.2.0.1
Allowed options:
  -h [ --help ]             produce help message
  -u [ --username ] arg     pCloud account name
  -p [ --password ]         Ask pCloud account password
  -c [ --crypto ]           Ask crypto password
  -y [ --passascrypto ] arg Use user password as crypto password also.
  -d [ --daemonize ]        Daemonize the process.
  -o [ --commands  ]        Parent stays alive and processes commands.
  -m [ --mountpoint ] arg   Mount point where drive to be mounted.
  -k [ --commands_only ]    Daemon already started pass only commands
  -n [ --newuser ]          Switch if this is a new user to be registered.
  -s [ --savepassword ]     Save password in database.

Also there are several commands that the running service can execute. Commands are passed using pcloudcc -k or starting the daemon with -o.

Available commands are startcrypto , stopcrypto, finalize, q, quit.

  • startcrypto - starts cripto using given password
  • stopcrypto – stops the crypto
  • finalize – stops the running daemon
  • quit, q - exits the current client, daemon stays alive

Example usage scenario

Start the service manually.

pcloudcc -u [email protected] -p -s

Enter password and use -s switch to save the password.

Verify that file system starts and mounts normally. If you don't have existing user use the -n switch to register new user.

pcloudcc -u [email protected] -p -s -n

Notice that a new user may take a while to mount. Please be patient.

Start the daemon service.

pcloudcc -u [email protected] -d

Verify file system is mounted.

At that point you can test passing some commands.

pcloudcc -u [email protected] -k

Or starting the daemon with -o. Test unlocking and locking crypto if you have subscribed for it.

Quit the client. Congratulations, your pcloud console client works properly. You can now add pcloudcc -u [email protected] -d command in you startup scripts and thus mount the file system on startup.

Debian package

To create a debian package form the source use the following command.

debuild -i -us -uc -b

Other distributions