Download Latest Version refractag-0-4-4 prealpha src.zip (191.5 kB)
Email in envelope

Get an email when there's a new version of refracTag (discontinued)

Home / refracTag 0.3.0-prealpha
Name Modified Size InfoDownloads / Week
Parent folder
readme_help.md 2014-10-26 5.9 kB
refractag-0-3-0 prealpha src.zip 2014-10-26 30.5 kB
refractag.exe 2014-10-26 5.2 MB
Totals: 3 Items   5.3 MB 0

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

Source: readme_help.md, updated 2014-10-26