https://github.com/miriti/ftags

Command-line files tagging tool
https://github.com/miriti/ftags

file-organiser file-organization files tagger tagging taggingtools

Last synced: 15 days ago
JSON representation

Command-line files tagging tool

• Host: GitHub
• URL: https://github.com/miriti/ftags
• Owner: miriti
• Created: 2018-01-15T21:50:58.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2018-01-19T20:54:39.000Z (almost 7 years ago)
• Last Synced: 2024-08-09T02:16:54.544Z (4 months ago)
• Topics: file-organiser, file-organization, files, tagger, tagging, taggingtools
• Language: JavaScript
• Homepage:
• Size: 9.77 KB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• jimsghstars - miriti/ftags - Command-line files tagging tool (JavaScript)

README

        
# ftags

**ftags** (File Tags) is a simple command line file tagging utility that helps to organize your files by assigning tags to them.

## Instalation

Assuming that you already have [Node.js](https://nodejs.org/) and [Npm](https://www.npmjs.com/) installed:

`npm i -g ftags`

## Usage

### Initialize ftags database (optional)

**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.

If 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:

```

ftags --init

```

### Tag a file

```

ftags example.txt tag1 tag2 'multiple words tag'

```

### List files marked with tags

```

ftags tag1 tag2

```

### Execute a command on files marked with tags

```

ftags tag1 tag2 --exec=open

```

This command will run the specified program and pass found files as arguments e.g.:

```

open file1 file2 file3

```