{"id":16000614,"url":"https://github.com/cjermain/gnome-gocryptfs","last_synced_at":"2025-06-12T12:03:15.418Z","repository":{"id":91390531,"uuid":"234821415","full_name":"cjermain/gnome-gocryptfs","owner":"cjermain","description":"gocryptfs managed with the GNOME keyring (fork of gnome-encfs)","archived":false,"fork":false,"pushed_at":"2023-10-15T15:08:16.000Z","size":134,"stargazers_count":3,"open_issues_count":5,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-22T11:24:28.824Z","etag":null,"topics":["gnome","gnome-gocryptfs","gocryptfs","keyring"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cjermain.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","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":"2020-01-19T01:23:19.000Z","updated_at":"2023-05-14T16:43:57.000Z","dependencies_parsed_at":"2024-10-30T05:43:51.416Z","dependency_job_id":null,"html_url":"https://github.com/cjermain/gnome-gocryptfs","commit_stats":{"total_commits":81,"total_committers":6,"mean_commits":13.5,"dds":0.5432098765432098,"last_synced_commit":"e97ab307f04ea14228ec993064d3ff77575ee71a"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjermain%2Fgnome-gocryptfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjermain%2Fgnome-gocryptfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjermain%2Fgnome-gocryptfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjermain%2Fgnome-gocryptfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cjermain","download_url":"https://codeload.github.com/cjermain/gnome-gocryptfs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245731497,"owners_count":20663198,"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":["gnome","gnome-gocryptfs","gocryptfs","keyring"],"created_at":"2024-10-08T09:05:03.089Z","updated_at":"2025-03-26T20:31:34.870Z","avatar_url":"https://github.com/cjermain.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"gnome-gocryptfs\n===============\n\n![](https://github.com/cjermain/gnome-gocryptfs/workflows/Run%20Tests/badge.svg)\n\n*gnome-gocryptfs* integrates [gocryptfs][cfs] folders into the GNOME desktop by storing\ntheir passwords in the [keyring][gkr] and optionally mounting them at login\nusing GNOME's autostart mechanism. This package is a fork of the [gnome-encfs][gef]\nproject.\n\n*gnome-gocryptfs* allows you to use strong passwords for gocryptfs folders while still\nmounting them painlessly (i.e. no password prompt).  This is an advantage over\nautomount solutions like *pam-encfs* and *pam-mount* which require to use the\nsame password for gocryptfs folders as for your local user account. This is bad\nbecause local account passwords usually are weaker than those one should use\nfor encrypting online stored data, e.g. in a [Dropbox][dbx].\n\nDownload\n--------\n\nCheckout the source:\n\n    $ git clone https://github.com/cjermain/gnome-gocryptfs\n\nInstallation\n------------\n\n    $ cd /path/to/gnome-gocryptfs\n    $ install gnome-gocryptfs /usr/local/bin\n\n**Note:** You can run *gnome-gocryptfs* right from the extracted package but to\nmake use of the automount feature at GNOME login, it must be placed somewhere\nin *PATH* (as configured during a login to GNOME). Using the install command\nabove ensures this requirement is fulfilled.\n\nUsage\n-----\n\n### Add a gocryptfs folder\n\nSuppose you have a gocryptfs folder at `~/.Private.encrypted` which should get\nmounted to `~/Private`. Make it known to *gnome-gocryptfs*:\n\n    $ gnome-gocryptfs add ~/.Private.encrypted ~/Private\n    gocryptfs config file [-]: \u003coptional custom gocryptfs.conf location\u003e\n    gocryptfs password: \u003center gocryptfs password\u003e\n    Mount at login [Y/n]: \u003csay 'y' or 'n'\u003e\n\nThis adds the gocryptfs path, its mount location and password to the GNOME keyring\nand sets up a GNOME autostart entry to mount it at GNOME login (if enabled).\n\n### Mount a gocryptfs folder\n\nIf you said *y* above to the login mount question, the gocryptfs folder gets\nmounted automatically at GNOME login. If you prefer to mount on demand, you do\nthat with\n\n     $ gnome-gocryptfs mount ~/Private\n\nwhich looks up the password in the keyring and does the mounting without\nthe need to enter the password manually.\n\nUnmount based on the path:\n\n    $ gnome-gocryptfs unmount ~/Private\n\nwhich can also take the mount path. Without a path, the unmount command\nunmounts all tracked gocryptfs folders.\n\n### Other tasks\n\nYou can also show, edit and remove gocryptfs folders handled by *gnome-gocryptfs*:\n\n    $ gnome-gocryptfs -h\n\n    usage: gnome-gocryptfs [-h] [--version]\n                           {list,mount,unmount,add,edit,remove} ...\n\n    Painlessly mount and manage gocryptfs folders using GNOME's keyring.\n\n    positional arguments:\n      {list,mount,unmount,add,edit,remove}\n        list                List all gocryptfs items stored in the keyring\n        mount               Mount all or selected paths stored in the keyring\n        unmount             Unmount all or selected paths stored in the keyring\n        add                 Add a new gocryptfs path to the keyring\n        edit                Edit a gocryptfs item in the keyring\n        remove              Remove a gocryptfs item from the keyring\n\n    optional arguments:\n        -h, --help            show this help message and exit\n        --version             show program's version number and exit\n\n    ...\n\nUsage should be straight forward - otherwise [submit an issue][itr].\n\n### Automatically unmount gocryptfs folders on logout\n\nUnfortunately there's no equivalent to GNOME's autostart scripts which could be\nused to automatically unmount your gocryptfs folders on logout (without shutting\ndown). However, there's a manual solution using a [GDM hook script][gdm]:\n`/etc/gdm/PostSession/Default`. Open this file in an editor (requires *root*\nprivileges) and add these lines:\n\n    mount -t fuse.gocryptfs | grep \"user=$USER\" | awk '{print $3}' | while read MPOINT ; do\n        sudo -u $USER fusermount -u \"$MPOINT\"\n    done\n\nThis script is executed whenever you logout from GNOME. With this line, it\nlooks for mounted gocryptfs folders of the user currently logging out. Then it\nunmounts each, using the `fusermount` command (note that this command is\nexecuted as *root*, that's why there is a `sudo -u $USER` before the\n`fusermount` command).\n\nThis works independent of *gnome-gocryptfs*, i.e. it unmounts **any** gocryptfs folder\nof the user logging out.\n\nLicense\n-------\n\n*gnome-gocryptfs* is licensed as [GPL][gpl].\n\n[gef]: https://hg.sr.ht/~obensonne/gnome-encfs\n[dbx]: http://dropbox.com\n[cfs]: https://nuetzlich.net/gocryptfs/\n[gdm]: http://library.gnome.org/admin/gdm/stable/configuration.html\n[gkr]: http://live.gnome.org/GnomeKeyring\n[gpl]: http://www.gnu.org/licenses/gpl.html\n[itr]: https://github.com/cjermain/gnome-gocryptfs/issues\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcjermain%2Fgnome-gocryptfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcjermain%2Fgnome-gocryptfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcjermain%2Fgnome-gocryptfs/lists"}