(-db|-database) <database/folder>

Creates or opens an existing database.

---

Tagging files

---

<filepath>

Adds & selects file for tagging (press enter to end tagging-mode).

<directory>

Adds & selects all files in the directory.

---

Tag operations on selected file(s)

---

• Manual tag editing.

  (-e|-edit) <tag1> <tag2> <tag3>

  Adds tags (for all items in current selection).

  (-e|-edit) - <tag1> <tag2>

  Removes the two tags (from all items in current selection).

  (-e|-edit) + <tag2> - <tag3>

  Adds and removes a tag (all items in current selection).

• Renaming tags (in current selection).

  (-r|-rename) <old-tag> <new-tag>

• Removing tags (from current selection).

  (-r|-rename) <tag-to-remove>

  Renaming to none removes the tag.

• Removing selected file metadata from the database

  -remove

---

Tagging text (aka "ideas")

---

(-i|-idea) <text>

Adds a tagged metadata item with the unique id being the idea itself.

(-ideas|-text)

Searches for ideas (in current selection).

---

Tagging remote links

---

<link>

Adds a link for tagging (in a similar way to ideas).

-links

Searches for links (in current selection).

-remote

Searches for ideas and links (in current selection).

---

Selecting

---

Type * or ** (additional hash-based file verification) for alavible tags.

The number of items selected is displayed inside the command prompt, ex: "{3}>"

To display the selection list type (-l|-list) or (-l+|-list+) for more info.

• Selecting by tags and index

  {0}> <tag1> <tag2> - <tag3>

  Selecting all items having tag1 and tag2 but not tag3.

  {10}> -s <indexes>

  Selecting by list index, ex: "2 3 4:7 8" (without ").

  • Joining the selections

    {0}> <tag1> <tag2> | <tag1> <tag3>

    or just:

    {0}> <tag2> | <tag3> * <tag1>

    Joins the two search request results.

---

Dealing with displaced/missing files

---

(-fix|-find) <directory/to/search/for/missing/files>

Does a recursive search for missing database items based on the item hashes.

(-lost|-missing)

Searches for missing files (in current selection).

---

Displaying search results

---

-t

Copies selected files into a temporary directory and opens it with a browser. After the browser is closed, the directory is removed.

(-o|-open)

Opens 1st item with the OS-default app.

(-o|-open) [<indexes> -x <APPLICATION-FILEPATH> [-s <indexes>]]

Opens items based on index (of current selection) with a specified app. In case the index is not defined, the selection is: all the items. It appends the file list as a parameter for the executable. The optional -s is for aliases based on -o to use custom index selection.

---

Multi-tasking

---

Delimit commands by ; to batch process (also as parameters).

---

Aliases

---

(-a|-alias) <alias> [<alias-extension>]

• Defining

  (-a|-alias) player [<path/to/player.ext>]

  From now on, "player" will be substituted by "path/to/player.ext".

  Some examples of usage:

  {0}> -a player path/to/player.ext

  {0}> -a play -o -x player -s

  {0}> retro music

  {7}> play

  or with index selection (-s):

  {7}> play 2:3 5

• Removing

  (-rma|-alias-remove) player

  Removes the alias "player" from the database.

---

Sub-Tags

---

Every tag containing a : (delimits its parts) is a sub-tag. You can search for the whole sub-tag or its parts.

Ex:

animal`:`frog

food`:`spaghetti

undefined`:`

---

File operations (be CAREFUL with these!)**

---

-copy <destination/directory>

-move <destination/directory>

(-RMDF|-REMOVE-DUPLICATE-FILES) <directory/to/process>

---

Other useful things

---

= <text1> _ <text2>

Akin to tag-search, this query searches for partial matches of text in tags. The above search includes all occurrences of <text1> without <text2>.

(-?|-count)

Display (sorted) tag count distribution (of current selection).

(->|-tags>)

(-<|-tags<)

(-=|-tags=)

Select items with specific tag count (from current selection).

(-dir|-directory-distribution)

Display file distribution by location and amount.

(-c|-copy-filepath|-clipboard) [<index>]

(-ch|-copy-hash) [<index>]

(-ct|-copy-tags) [<index>]

Clipboard copy. Works with multiple items.

Pro-tip: The ini/configuration file contains some options.

To use word-substitution (wordnet) in tag search: 1. Download the dictionary resources by typing: "-wordnet-download" 2. Set "use_wordnet = True" in the ini/config file.

(-cls|-clear)

Clears the console screen!

(-exit|-quit)

Terminates refracTag - useful in batch processsing.

(-inv|-inverse-selection)

Inverses the current metadata selection.