{"id":15136344,"url":"https://github.com/gnojus/nec","last_synced_at":"2025-10-23T11:31:25.728Z","repository":{"id":65127305,"uuid":"582467291","full_name":"gnojus/nec","owner":"gnojus","description":"nec - Nextcloud command line tool for sharing files","archived":false,"fork":false,"pushed_at":"2024-08-23T17:56:08.000Z","size":34,"stargazers_count":24,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-01-30T18:05:28.861Z","etag":null,"topics":["cli","command-line","nextcloud","nextcloud-desktop-client"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gnojus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-26T23:41:08.000Z","updated_at":"2024-10-06T13:23:12.000Z","dependencies_parsed_at":"2024-06-20T03:19:17.694Z","dependency_job_id":"e40e6dd0-356e-4ec8-a608-fd9d0155c591","html_url":"https://github.com/gnojus/nec","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnojus%2Fnec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnojus%2Fnec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnojus%2Fnec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnojus%2Fnec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gnojus","download_url":"https://codeload.github.com/gnojus/nec/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237821544,"owners_count":19371781,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","nextcloud","nextcloud-desktop-client"],"created_at":"2024-09-26T06:21:03.905Z","updated_at":"2025-10-23T11:31:25.393Z","avatar_url":"https://github.com/gnojus.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"nec - Nextcloud command line client\n===================================\n`nec` is a command line tool for [Nextcloud](https://nextcloud.com/), primary\nfor sharing files. It's made to be cross-platform, tested on Mac OS, Windows\nand Linux, on Linux working at least on KDE with kwallet and other libsecret\nbackends.\n\nInstallation\n------------\nDownload prebuilt binaries on [releases](https://github.com/gnojus/nec/releases)\nor build with `go install github.com/gnojus/nec@latest`. Note that CGO\n(`CGO_ENABLED=1`) is required to build with keychain support for Mac OS.\n\nThe Github releases also feature self-updating capabilities via `update` command\n(since `v0.0.11`).\nWhen building from source updates can be enabled using linker flags:\n`-ldflags \"-X main.version=\u003cversion\u003e -X main.repo=gnojus/nec\"`.\n\nUsage\n-----\nnec is intended to be zero-configuration tool. This means that it works alongside\nofficial [Nextcloud desktop client](https://github.com/nextcloud/desktop/). It parses\nthe existing configuration and operates on the folders of local filesystem, synced\nwith server. \n\nThis tool does not upload files, it only shares ones that are synced with the server.\nTherefore if you want to share a file that is not synced, you may want to move/copy\nit to a folder that is synchronized and share it from there. The upload will be\nperformed by the desktop client.\n\n### Commands\nMost nec commands take local path as an argument, but the actually affected file\n(shared or unshared) is the one on the server, synced to the local one by desktop\nclient.\n\n    $ nec --help\n    Usage: nec \u003ccommand\u003e\n\n    nec is a command line tool for file sharing on Nextcloud. It parses the existing\n    configuration of the official desktop client and operates on the folders of\n    local filesystem, while actually sharing the files that are synced with the\n    server.\n\n    Commands:\n      share (s)       share a local file\n      unshare (us)    unshare a local file\n      list (ls)       list shares of local files\n      update          update nec using github releases if new version available\n\n    Run \"nec \u003ccommand\u003e --help\" for more information on a command.\n\n### Example\n    $ ls\n    api.go  config.go  go.mod  go.sum  LICENSE  list.go  main.go  README.md  share.go  unshare.go\n    $ nec s README.md\n    https://cloud.example.com/s/NB8LiLSgqpSmPxW\n    $ nec share README.md --expire 'in 1 week' --note 'nec readme'\n    share expires on: 2023-01-13\n    https://cloud.example.com/s/DHHLgYxjNmJDsCr\n    $ nec ls README.md\n    65  https://cloud.example.com/s/NB8LiLSgqpSmPxW\n    66  https://cloud.example.com/s/DHHLgYxjNmJDsCr  2023-01-13  nec readme\n    $ nec ls -r .\n    README.md  65  https://cloud.example.com/s/NB8LiLSgqpSmPxW\n    README.md  66  https://cloud.example.com/s/DHHLgYxjNmJDsCr  2023-01-13  nec readme\n    $ nec us --id 65\n    $ nec ls -r .\n    README.md  66  https://cloud.example.com/s/DHHLgYxjNmJDsCr  2023-01-13  nec readme\n\nIssues\n------\nThe tool is in the early stage of developent, but should get the job done.\nPlease report any bugs or suggestions on the [Github issue tracker](https://github.com/gnojus/nec/issues).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnojus%2Fnec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgnojus%2Fnec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnojus%2Fnec/lists"}