From the Command Line

Documentation / Contents - File Handlers

• Overview of File Handlers
  • The Pair
  • What a File Type Is
• Opening a File
  • What Happens When You Open Something
  • Opening With a Particular Tool
• The File Handlers Panel
  • The File Type List
  • The Opens With List
  • The Detail Line
  • The Buttons
• Choosing a Handler
  • Auto-Pick Best
  • Try It
  • Opening Nothing
• Icons
  • The Available Icons List
  • Set Icon
• Creating New Files
• The Canonical Panel
• Where the Settings Live
  • The Master List
  • The Rule Files
  • The Ranking Tables
• From the Command Line
• Copyright Information

From the Command Line

cyopen is a real command and is useful as one. Everything the desktop does through it, you can do at a shell prompt.

Opening

cyopen FILE ...            open each with its type's handler
cyopen --print FILE        print the command, do not run it
cyopen --with TOOL FILE    run TOOL on the file, quoted

Looking

cyopen --list           every type, icon and handler
cyopen --classes        the handler classes
cyopen --discover       which candidates are installed here
cyopen --resolve TYPE   the best handler for TYPE here
cyopen --provenance     name the package each binary is from

--provenance is an addition to the listing output, not a mode of its own. It asks the system package manager which package owns each program, which is how you tell two identically named binaries apart.

Writing

cyopen --autofill    rescan, fill the gaps
cyopen --write       write the mirror rule file
cyopen --dry-run     with --write, print, do not write

--autofill and --write are usually run together:

cyopen --autofill --write

Run --dry-run first if you want to read the result before it lands.

Creating

cyopen --list-create    the live create recipes
cyopen --create PATH    create PATH if missing, then open

See Creating New Files.

The Panel

cyopen-prefs                the File Handlers panel
cyopen-prefs --canonical    the canonical face

See The File Handlers Panel and The Canonical Panel.

The Standard Flags

Both programs take the house flags: --help, --version, --selftest and --log=LEVEL. --selftest runs the internal checks with no display and no window, which includes the shell quoting, so it is safe on a machine you do not want to disturb.