{"id":19983054,"url":"https://github.com/madmurphy/nautilus-annotations","last_synced_at":"2025-05-04T05:32:55.584Z","repository":{"id":46940121,"uuid":"363376523","full_name":"madmurphy/nautilus-annotations","owner":"madmurphy","description":"Annotate files and directories","archived":false,"fork":false,"pushed_at":"2023-11-19T17:31:23.000Z","size":888,"stargazers_count":24,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-08T04:34:10.880Z","etag":null,"topics":["annotations","c","desktop","desktop-environment","file-manager","file-metadata","gio","gnome","gnu","gnu-linux","gtk","gtksourceview","gvfs","gvfs-metadata","markdown","metadata","nautilus","nautilus-extension","notes"],"latest_commit_sha":null,"homepage":"","language":"C","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/madmurphy.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-05-01T09:56:37.000Z","updated_at":"2025-01-26T16:31:50.000Z","dependencies_parsed_at":"2023-01-30T18:31:04.767Z","dependency_job_id":null,"html_url":"https://github.com/madmurphy/nautilus-annotations","commit_stats":null,"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madmurphy%2Fnautilus-annotations","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madmurphy%2Fnautilus-annotations/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madmurphy%2Fnautilus-annotations/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/madmurphy%2Fnautilus-annotations/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/madmurphy","download_url":"https://codeload.github.com/madmurphy/nautilus-annotations/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252293082,"owners_count":21724960,"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":["annotations","c","desktop","desktop-environment","file-manager","file-metadata","gio","gnome","gnu","gnu-linux","gtk","gtksourceview","gvfs","gvfs-metadata","markdown","metadata","nautilus","nautilus-extension","notes"],"created_at":"2024-11-13T04:14:00.992Z","updated_at":"2025-05-04T05:32:54.369Z","avatar_url":"https://github.com/madmurphy.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"Nautilus Annotations\n====================\n\nAnnotate files and directories\n\n\nDetails\n-------\n\nLong time ago **GNOME Files** (**Nautilus**) had the ability to handle custom\nannotations attached to files and directories. This ability has slowly gone\nlost in the folds of time. Things however are rarely really unlearned, and an\nability rarely goes away for good.\n\n**Nautilus Annotations** brings back **Nautilus**' annotation capabilities. It\nexploits the same machinery that was used back then: that of relying on **GIO**\nto store custom information about a file or a directory.\n\nEach annotation is stored as a `metadata::annotation` entry in **GIO**'s\ndatabase. An “Annotations” column containing a short preview of what has been\nannotated is made available to Nautilus. Annotated files are shown in the\nviewport with an emblem attached.\n\nTo erase an annotation it is sufficient to leave the content blank, and the\nextension will take care of erasing the database entry.\n\nThe dialog window for editing the annotations is very minimal, albeit polished\nand with Markdown highlighting enabled.\n\nThanks to **GIO**, when a file is moved or renamed its annotations remain\nsynchronized with the new path.\n\nAnnotations are “per user”. This means that although Alice has the right to\nannotate Bob's files, only Alice will have access to her own annotations.\n\nAnnotation emblems are displayed by the extension and will not be shown once\nthe extension is uninstalled (the `metadata::emblems` database entry for the\nfile is left untouched). The content of the annotations instead is managed by\n**GIO** and will survive uninstalling the extension.\n\nWith version 2.0.0 an emblem picker has been added to the annotations window.\nDifferently than the text annotation emblem, this _will_ change the\n`metadata::emblems` database entry for the file and the emblems set in this way\nwill survive uninstalling the extension.\n\nEmblems and annotations are stored in `~/.local/share/gvfs-metadata`. It is\npossible to access annotations via command line by launching:\n\n``` sh\ngio info -a metadata::annotation /path/to/file\n```\n\nTo set an annotation via command line launch:\n\n``` sh\ngio set /path/to/file metadata::annotation 'Content of annotation goes here'\n```\n\nTo unset an annotation via command line launch:\n\n``` sh\ngio set -t unset /path/to/file metadata::annotation\n```\n\nTo set the group of emblems via command line launch:\n\n``` sh\ngio set -t stringv /path/to/file metadata::emblems emblem-one emblem-two \\\n\temblem-three ... emblem-nth\n```\n\nTo unset all emblems via command line launch:\n\n``` sh\ngio set -t unset /path/to/file metadata::emblems\n```\n\n\nGet involved\n------------\n\nThe package needs help with internationalization. If a translation into your\nlanguage is missing and you wish to get involved, here is what to do.\n\nLet's say you want to create a Dutch translation of **Nautilus Annotations**\n(`nl`). First thing to do is to make sure that **GNU Autotools** and **GNU\ngettext** are installed on your system. Then clone this repository and launch\nthe following commands:\n\n``` sh\n./bootstrap\nmake -C po nautilus-annotations.pot\n(cd po \u0026\u0026 msginit -l nl)\n./bootstrap --clean\n```\n\nNow edit the `po/LINGUAS` file and add a new line containing the abbreviated\nname of the new language (`nl`).\n\nFinally, open the `po/nl.po` file and translate the strings present. All you\nhave to do now is to commit your changes.\n\nFor any issue, [drop a message][1].\n\n\nInstallation\n------------\n\nOn most Unix-like systems, you should be able to install this package using the\nfollowing common steps:\n\n``` sh\n./configure\nmake\nmake install-strip\n```\n\nIf the `strip` utility is not available on your machine, use `make install`\ninstead (it will produce larger binaries).\n\nIf the `configure` script is missing from your package you need to generate it\nby running the `bootstrap` script. By default, `bootstrap` will also run the\n`configure` script immediately after having generated it, so you may type the\n`make` command directly after `bootstrap`. To list different options use\n`./bootstrap --help`.\n\nFor further information, see [INSTALL][2].\n\n\nNExtGen\n-------\n\nThis extension has been created using [NExtGen][3] Nautilus extension\ngenerator.\n\n\nFree software\n-------------\n\n**Nautilus Annotations** is free software. You can redistribute it and/or\nmodify it under the terms of the GPL license version 3 or any later version.\nSee [COPYING][4] for details.\n\n\n  [1]: https://gitlab.gnome.org/madmurphy/nautilus-annotations/issues\n  [2]: INSTALL\n  [3]: https://gitlab.gnome.org/madmurphy/nextgen\n  [4]: COPYING\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmadmurphy%2Fnautilus-annotations","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmadmurphy%2Fnautilus-annotations","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmadmurphy%2Fnautilus-annotations/lists"}