cec ls

List files in your Cells server



List files in your Cells server.


Use as a normal ls, with additional path to list sub-folders or read info about a node. You can use one of the below optional flags: - d (--details) flag to display more information, - r (--raw) flag to only list the paths of found files and folders - f (--exists) flag to only check if given path exists on the server. - format flag with a valid go template to get a custom listing.

Note that you can only use one of the above flags at a time.

As reference, known attributes for the Go templates are: - Type: File, Folder or Workspace - Uuid: the unique ID of the corresponding node in the Cells Server - Name: name of the item - Path: the path from the root of the server - HumanSize: a human-friendly formatted size - SizeBytes: the size of the object in bytes - TimeStamp: number of seconds since 1970 when the item was last modified - Date: a human-friendly date for the last modification

Note that the last 4 meta-data are only indicative for folders: they might be out of date, if the listing happens shortly after a modification in the sub-tree.


1/ Listing the content of the personal-files workspace

$ ./cec ls personal-files +--------+--------------------------+ | TYPE | NAME | +--------+--------------------------+ | Folder | . | | File | Cat.jpg | | File | Photo.png | | Folder | Others | | File | info.txt | | Folder | recycle_bin | +--------+--------------------------+

2/ Showing details about a file

$ ./cec ls personal-files/photo.jpg -d Listing: 1 results for personal-files/photo.jpg +------+--------------------------------------+-----------------------------+--------+------------+ | TYPE | UUID | NAME | SIZE | MODIFIED | +------+--------------------------------------+-----------------------------+--------+------------+ | File | 98bbd86c-acb9-4b56-a6f3-837609155ba6 | personal-files/photo.jpg | 3.1 MB | 5 days ago | +------+--------------------------------------+-----------------------------+--------+------------+

Will show the metadata for this node (uuid, size, modification date)

3/ Only listing files and folders, one per line.

$ ./cec ls personal-files -r Cat.jpg info.txt Huge Photo.jpg ...

4/ Using a template:

$ ./cec ls personal-files --format '"{{.Name}}";"{{.Type}}";"{{.Path}}";"{{.HumanSize}}";"{{.Date}}"' personal-files/ "Cat.jpg";"File";"personal-files/Cat.jpg";"1.3 MB";"2 months ago" "Others";"Folder";"personal-files/Others";"12 MB";"11 minutes ago" "Photo.png";"File";"personal-files/Photo.png";"8.1 MB";"3 minutes ago" ...

5/ Check path existence.

$ ./cec ls personal-files/info.txt -f true

$ ./cec ls personal-files/not-here -f false

./cec ls [flags]


  -d, --details         Show more information about retrieved objects
  -f, --exists          Check if the passed path exists on the server and return non zero status code if not
      --format string   Use go template to format each line of the output listing
  -h, --help            help for ls
  -r, --raw             List found paths (one per line) with no further info to be able to use returned results in later commands

Options inherited from parent commands

      --config string     Location of Cells Client's config files (default: /home/teamcity/.config/pydio/cells-client/config.json)
      --log string        change log level (default: info) (default "info")
      --login string      The user login, for Client auth only
      --no-cache          Force token refresh at each call. This might slow down scripts with many calls
      --password string   The user password, for Client auth only
      --skip-keyring      Explicitly tell the tool to *NOT* try to use a keyring, even if present. Warning: sensitive information will be stored in clear text
      --skip-verify       By default the Cells Client verifies the validity of TLS certificates for each communication. This option skips TLS certificate verification
  -t, --token string      A valid Personal Access Token (PAT)
  -u, --url string        The full URL of the target server


  • ./cec - Connect to a Pydio Cells server using the command line
Auto generated by Cells Client v4.2.0 on 24-Jun-2024
Back to top