Skip to content

fabianostermann/nextcloud-status

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 

Repository files navigation

Nextcloud command-line tool for querying client sync status

This is a python script that reports the current status of synchronization of the nextcloud-desktop-client (Linux only).

This is done by connecting to the nextcloud client socket, which is also used by the official syncstate nautilus-extension to show icon overlays that indicate sync status.
Much of the code is borrowed there.

To test if it works for you, just run:

python nextcloud-status.py

Will print either Up to date or Syncing.. to stdout (or warnings/errors).
For now, I decided to match the behavior of dropbox status, because I formerly used the Dropbox cloud service and integrated their command-line tool in many of my personal scripts.
This is also, why I decided to build this tool in the first place.

You can also list all files that are currently syncing (-r) or query files explicitly:

$ python nextcloud-status.py --help
USAGE: ./nextcloud-status.py [-h|--help] [--debug] [-r|-R|--recursive] [files..]

Install

To install it globally, mark it executable and copy it to /usr/bin.

chmod +x nextcloud-status.py
cp nextcloud-status.py /usr/bin/nextcloud-status

Then run nextcloud-status in your terminal.

If you have any questions, find bugs or have ideas for new featues, feel free to open an issue!
I also opened a discussion at the official nextcloud issue tracker.

Roadmap

-[x] Add command-line usage info (-h/--help) -[x] Add feature to check sync status recursively -[ ] Add other socket queries (e.g. ). All possible socket requests are listed here. -[ ] Clean up code (currently, the logic of recursive mode and print messages is a bit confusing, which is bad when bugs occur or new features are to be added)

About

Python script reporting the current sync status of the nextcloud desktop client.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages