Command Line

Documentation / CySelect

• Overview of CySelect
  • What It Does
  • What It Is Not
• Using CySelect
  • Calling From A Script
  • Modes You Will Use
  • Filters And Last Directory
  • Selecting In The Dialog
• Command Line
  • Modes
  • Options
  • Keys
  • Exit Status
• Copyright

Command Line

cyselect opens one dialog, prints absolute path(s) on stdout, and exits. Exactly one mode flag is required (except --help / --version / --selftest).

cyselect --file-selector --title 'Open' --start=/home

Modes

• --file-selector -- open one file
• --directory-selector -- choose one directory
• --multi-file -- one or more files (lasso / Ctrl / Shift)
• --multi-dir -- one or more directories
• --multi -- one or more files and/or directories
• --multi-file-selector -- alias for --multi-file
• --save -- Save As (multi-select rejected)

Options

• --start=PATH -- initial directory (default: last for --app-id, or $HOME)
• --title=TEXT -- dialog window title
• --app-id=ID -- per-app last-directory key (default: cyselect)
• --default-name=NAME -- Save As default filename
• --type=GLOB -- name filter (repeatable); builds the Filter menu and seeds the path field (for example /tmp/*.jpg)

cyselect --save --default-name=notes.txt --start=/tmp
cyselect --multi-file --type='*.png' --type='*.jpg' --app-id=cypix

Keys

When the icon canvas has focus (default on open):

• arrows / Home / End -- move or jump the selection
• Shift+arrows -- extend the selection
• Backspace -- parent directory
• Enter -- activate (open file or enter directory)
• Ctrl-A -- select all (multi modes)

Dialog chords (also with path or Save name focused):

• Esc -- cancel
• Ctrl-O -- Open / Choose / Select
• Ctrl-S -- Save (Save mode only)
• Ctrl-L -- focus the path field

Exit Status

• 0 -- success; one absolute path per stdout line
• 1 -- cancel; no path lines
• 2 -- usage or error; message on stderr

Help And Selftest

• -h, --help / -V, --version
• --selftest -- headless DirView / mode enum checks

See Also

• Using CySelect
• Overview of CySelect