{"id":13941815,"url":"https://github.com/miriti/ftags","last_synced_at":"2026-01-30T12:49:13.169Z","repository":{"id":145429292,"uuid":"117599192","full_name":"miriti/ftags","owner":"miriti","description":"Command-line files tagging tool","archived":false,"fork":false,"pushed_at":"2018-01-19T20:54:39.000Z","size":10,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-27T11:37:11.756Z","etag":null,"topics":["file-organiser","file-organization","files","tagger","tagging","taggingtools"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/miriti.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-01-15T21:50:58.000Z","updated_at":"2023-09-08T17:35:15.000Z","dependencies_parsed_at":"2023-06-03T18:00:19.777Z","dependency_job_id":null,"html_url":"https://github.com/miriti/ftags","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/miriti/ftags","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miriti%2Fftags","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miriti%2Fftags/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miriti%2Fftags/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miriti%2Fftags/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/miriti","download_url":"https://codeload.github.com/miriti/ftags/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miriti%2Fftags/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266071519,"owners_count":23871940,"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":["file-organiser","file-organization","files","tagger","tagging","taggingtools"],"created_at":"2024-08-08T02:01:29.981Z","updated_at":"2026-01-30T12:49:13.125Z","avatar_url":"https://github.com/miriti.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# ftags\n\n**ftags** (File Tags) is a simple command line file tagging utility that helps to organize your files by assigning tags to them.\n\n## Instalation\n\nAssuming that you already have [Node.js](https://nodejs.org/) and [Npm](https://www.npmjs.com/) installed:\n`npm i -g ftags`\n\n## Usage\n\n### Initialize ftags database (optional)\n\n**ftags** stores it's data in a single database file (`.ftags.db`). By default **ftags** searches for this file in the currect working directory. If it won't be able to locate it there it will try to find it in all the parent directories up to the root of the file system. If the file won't be found after that it will be assumed that the global database file should be used. Global database default location is the home directory of the user.\n\nIf you wan't to create a new `.ftags.db` file in the current directory and those scope it out from the global database just use the `--init` option in the command:\n\n```\nftags --init\n```\n\n### Tag a file\n\n```\nftags example.txt tag1 tag2 'multiple words tag'\n```\n\n### List files marked with tags\n\n```\nftags tag1 tag2\n```\n\n### Execute a command on files marked with tags\n\n```\nftags tag1 tag2 --exec=open\n```\n\nThis command will run the specified program and pass found files as arguments e.g.:\n\n```\nopen file1 file2 file3\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiriti%2Fftags","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmiriti%2Fftags","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiriti%2Fftags/lists"}