Skip to content

Latest commit

 

History

History
144 lines (118 loc) · 4.81 KB

README.md

File metadata and controls

144 lines (118 loc) · 4.81 KB
Raw

Tavinus Cloud Manager

Nextcloud / Owncloud CLI Webdav Client

Uses curl to access the Nextcloud webdav service.

If you want to send files to publicly shared Nextcloud/Owncloud folders,
check out my Cloud Sender 2 App.

If you want to support this project, you can do it here ☕ 🍺

paypal-image

Features

Tries to be feature-complete with the Nextcloud Webdav's capabilities.

Webservice Tasks

  • list file/folder
  • create folder
  • send file
  • send folder (not avail on Webdav)
  • get file
  • get folder (not avail on Webdav)
  • delete file/folder
  • move file/folder
  • copy file/folder
  • list shares
  • list links

Internal App Goals

  • target folder detection redirection
    will use source file name when target ends with /
  • external config files
  • reset config files
  • multiple users
  • multi-language support
  • auto-detect / auto-load system language
  • force language from param
  • run from symlinks (find config files)
  • load specific config files from params

Configuration

There are two configuration files that need to be edited

cloudmanager.server

Defines the target server domain, protocol and port

# Edit the shell variables below
CLOUDSERVERDOMAIN='cloud.domain.tld'
CLOUDSERVERPROTOCOL='https://'
CLOUDSERVERPORT=443

cloudmanager.accounts

Defines the usernames/passwords to be used
The first user is used as default

---- Add accounts one per line, as in USERNAME:PASSWORD
---- You can use an "App Password" to access your account (instead of your regular password)
---- Settings > Personal > Security > Enter App Name > Create new app password
---- The first user is the default user, the rest can be used with -u <usernamme>
---- Lines starting with four dashes will be ignored
myUsername:myPassword

Localization

CloudManager supports localization and automatic language detection.
You can also force a language with -l <language_code>.

Currently supported languages

  • en_US
  • pt_BR

Help

You can use the parameters -h or --help to get the help information.

$ ./cloudmanager -l en --help

Tavinus Cloud Manager v0.1.9

CONFIG
 - cloudmanager.server    Edit this file to configure host domain, protocol and port
 - cloudmanager.accounts  Edit this file to add nextcloud accounts
                          The first user of the list is the default user
                          You may use an "app" token instead of the user password (safer)

 Both config files MUST be populated before you try to use Cloud Manager

OPTIONS

 -V, --version             Prints version to screen and finishes execution
 -v, --verbose             Prints execution information to screen
 -h, --help                Prints this help to screen and finishes execution
     --resetServerConfig   Resets server config file to default
     --resetAccountsConfig Resets accounts config file to default
     --resetAll            Resets all config files
 -u, --user <username>     Loads the user <username> from the cloudmanager.accounts file
 -l, --language <lang>     Force the language <lang>
                           Languages currently supported:
                           en_US pt_BR

NOTES
 - Target locations ending with a forward dash / will be treated as folders and
   will have the source name file appended to it as a target location.

COMMANDS

> ls,list [target]
    Lists a folder or file (lists root folder if empty)
    Ex:  list

> mkdir,makeFolder <foldername>
    Creates a folder at the cloud
    Ex:  mkdir MyTestFolder

> send,upload <localfolder/localfile> [cloudfolder/cloudfile]
    Sends a local file to the cloud instance
    Ex:  send '/home/user/MyFile.xml' 'CloudFolder/MyFile.xml'

> mv,move <source> <target>
    Moves a folder or file inside the cloud instance
    Ex:  move 'OneFolder/MyFile.txt' 'AnotherFolder/MyFile.txt'

> cp,copy <source> <target>
    Copies a folder or file inside the cloud instance
    Ex:  copy 'OneFolder/MyFile.txt' 'AnotherFolder/MyFile.txt'

> del,delete <target>
    Erases a folder or file inside the cloud instance (may move to Trashbin)
    Ex:  del 'MyFolder/MyFile.txt'

> get,download <source> [target]
    Downloads a file from the cloud to a local folder
    Target defaults to current folder with remote name if blank
    Ex:  get 'RemoteFolder/RemoteFile.txt' '/home/user/MyFile.txt'

> shares,listShares [folder]
    Prints table with shares (183 cols)
    Specify a folder or leave blank to list all
    Ex:  shares

> links,sharedLinks
    List shares by links using the format <URL>,<FILE NAME>
    Ex:  listShares