GP SoftwareTwitter
Opus FAQsManualCommandsObjects

Directory Opus 12.7.3 (beta)


Directory Opus 12.7.3 (beta) is now available for all Opus 12 users.

This is a preliminary, beta release. Translations may not be fully up-to-date and some English text may appear in non-English versions.

This is an Opus 12 update. If you are using Opus 11 or earlier then you should not install this beta unless you want to upgrade to Opus 12.



  • The Rename tool has a new mode, Regular Expressions + Find And Replace, which combines both modes (lets you search and replace within filenames using regular expressions, without having to construct a pattern to match the whole name).
  • The Duplicate Finder tool now has a Size mode which only finds duplicates based on their size (ignoring name, date and contents). The Find command has a new SIZEONLY argument to activate this mode from a command.
  • Buttons can now be hidden or disabled based on the number of selected files or folders. For example, @hidenosel:minfiles=2,maxfiles=4 will hide a button unless 2, 3 or 4 files are selected.
  • The {foldercontents} and {foldersize} infotip fields can now be configured to control what they show:
    • noprefix can be used to remove the normal prefix added to the field (e.g. {foldersize:noprefix})
    • files and dirs can be used for {foldercontents} to only show one type of content {e.g. {foldercontents:files,noprefix})
  • The Preferences / Miscellaneous / Advanced / use_color_management option now allows an external ICC file to be selected (as well as the built-in sRGB profile). Additionally, PNG files with embedded ICC profiles are now supported as well as JPEGs.
  • The Show command now has POS and SIZE arguments that let you specify a position and/or size for the standalone viewer window.
  • Added Set VIEWPANELOCK command. When the viewer pane lock is turned on, it will continue to display its current image even if the file selection is changed in the Lister.
  • Folder tab group changes:
    • Menus for selecting folder tab groups now highlight the "active" group, i.e. the one which was last loaded. You can use Go TABGROUPLIST=nohighlight to prevent this on user-editable toolbars and menus.
    • When saving over a tab group, the suggested group name now comes from the display you are saving from (if applicable) and not always the source display.
    • When saving over a tab group, the dialog now opens with the existing tab group name pre-selected.
    • You can now use Go TABGROUPSAVE=!forget to tell the file display to de-couple itself from any loaded tab group (e.g. so the group's name is no longer selected in the list of tab groups).
    • The Go TABGROUPSAVE command also now has !closeall and !nocloseall keywords which override the state of the Close all other tabs flag. These existed previously but were undocumented, and the way the flag behaves when saving over existing groups has been improved slightly.
    • You can now use Go TABGROUPSAVE=!current to save over the last folder tab group which was loaded. If no group is loaded, you will be prompted to name a new one, unless you add !quiet as well. You can also use !unless to skip saving if a particular group is currently loaded. Details in the manual.
    • You can now use Go TABGROUPLIST=savecurrent on a toolbar to generate a list of buttons for each folder tab group where any changes to the current group (if any) will be saved automatically before switching to another group. Note that this does not cover saving the current group in other situations like closing the Lister, and consideration is needed if you use this with multiple Listers at once. More detail in the manual.

  • Added a new FileGroup script object which exposes information about a file group (when a Tab is set to group by a particular column).
    • The Tab object has a new filegroups property which returns a collection of FileGroup objects representing all file groups in the Tab.
    • The Item object has a new filegroup property which returns a FileGroup object representing the group the item is a member of.
  • Added scripting FileAttr object, to better represent file attributes.
    • A new FileAttr object can be created by the FSUtil.NewFileAttr() method.
    • The Format object's hide_attr, show_attr, hide_folder_attr and show_folder_attr properties now return FileAttr objects instead of strings.
    • The Item object has a new fileattr property that returns a FileAttr object (the existing attr and attr_text properties are unchanged).
    • The File.SetAttr() method now accepts a FileAttr object as well as a string.
  • If a string is passed to File.SetAttr() (rather than a FileAttr object), + and - can be used to set and clear attributes rather than replacing the attributes entirely. For example, File.SetAttr("-r") to clear the read-only attribute.
  • Script columns can now use the additional types graphrel, igraphrel and percentrel. These are similar to the existing types graph, igraph and percent except that the values your script provides do not need to be limited to the range 0 to 100. Instead, Opus will keep track of the smallest and largest values returned and automatically calculate each file's relative percentage. You can also use the types graphrel0, igraphrel0 and percentrel0 which always use 0 as the lower-bound value (and Opus will simply keep track of the largest value you return).
  • The ScriptColumn script object has new properties (graph_colors, graph_colors2 and graph_threshold) that let you control the color of graphs drawn in a graph column.
  • Script dialog controls now have properties and methods to get and set their position within the client area of the dialog. The properties x, y, cx and cy let you get and set the left, top, width and height of the control. The SetPos, SetSize and SetPosAndSize methods let the position and size be set in a single call.
  • Scripts that open files for writing using the FSUtil.OpenFile method can now specify "f" as part of the mode string to automatically remove the read-only attribute from existing files.
  • Scripts that ask to overwrite read-only (R attribute) files will no longer trigger unnecessary UAC prompts.
  • FileSize objects can now be initialised from a Blob as well as the existing value types. The Blob must contain exactly 1, 2, 4 or 8 bytes. The new ToBlob method lets you convert a FileSize to a Blob.
  • Added the Blob.Reverse method.

  • MD5 accuracy slider in the Duplicate Finder tool has up/down cursor key direction swapped.
  • Status bar codes for showing the name and other details about the last-selected file now work in all types of folder.
  • Fixed an empty archive being left around if archive creation failed or was cancelled, when using the Add To Archive dialog, or when the destination archive required elevation to create.
  • Fixed another issue where modifying a non-zip archive could cause the Lister to react as if the archive had been deleted (e.g. go up to the parent path).
  • Fixed the Favorites ALIAS=set and ALIAS=delete commands when used on toolbars. They previously only worked via hotkeys and scripts.
  • @hidenosel and @disablenosel patterns and file/dir limits now work in the context menus for the folder tree and file display.
  • The New context menu in Opus no longer filters out types that have identical content type specifications. This check (and questionable filetype registrations by other programs) may have resulted in the New Text Document menu being missing on some machines. Note that you may now see two almost identical items in the New menu for Microsoft Access, but this behavior is correct, and Microsoft's fault, and the same is true in Explorer.
  • Fixed incompatibility with drag & drop from ISOBuster.
  • The standalone viewer slideshow speed setting in Preferences now allows fractions of a second to be specified (using a decimal point).
  • The three tabs in the Advanced Function editor when it's in script mode now remember their cursor position and selection range when you switch between them.
  • The Create Folder dialog no longer allows strings containing colons (and other invalid filename characters) to be pasted in from the clipboard.
  • Fixed not being able to set Preferences / Miscellaneous / Advanced: clipboard_image_paste to JPG for some configs which date back to older versions of Opus.
  • The path field's ghost path breadcrumbs are now cleared when you right-click the path field and choose Clear History, or when you run the Recent CLEAR command.
  • Fixed archive extract-to-subfolder failure when the archive name had a space before the extension.
  • Experimental fix for file change notification not working in collections when files are added via a junction or mount point.
  • The @toggle and @icon modifiers can now test conditions based on any internal command, not just the Set command.
  • Opus will now show an error when you try to copy a file > 4GB in size to a FAT or FAT32 drive.
  • The confirmation dialog when deleting a single file now truncates long filenames in the middle (e.g. aaa...ccc) rather than at the end (aaabbb...).
  • The current per-tab font scaling setting is now saved as part of layouts and styles.
  • The Rename dialog's preset list now shows a tooltip for any presets whose names are too wide for the list to show completely.
  • Removing files from a collection can now be undone.
  • The metadata pane should now recognise .m4a files properly (previously it was only checking for audio/x-m4a content type, it now checks for audio/mp4 as well).
  • Dragging a "modern" application (e.g. Calculator) from the start menu to an Opus Lister now correctly creates a shortcut to the app.
  • Combining the Select SOURCETODEST command with the HIDEUNSEL argument now correctly hides unselected items in the destination file display.
  • The Align other Lister element headers with the file display border Preferences option is now disabled if more than one toolbar is selected for the FDB.
  • The COPYDIRTIMES and COPYFILETIMES (and several other arguments) for the Copy command did not work in conjunction with the EXTRACT argument.
  • Fixed a problem where renaming a folder by only changing the case of its name (e.g. "test" to "TEST") would cause it to be removed from the folder tree.
  • Fixed problem with misreported duration of some AVI video files.
  • When the file display is grouped and in details mode, pushing shift+up/down would sometimes not scroll the list far enough to show the next selected file.
  • Fixed glitch in new FDB toolbar Preferences page if you removed all toolbars from the FDB toolbar list and clicked OK.
  • In the viewer pane, Opus would show the wrong cursor if the Expand and scroll was turned on but the parent option Scroll with left mouse button was turned off.
  • If you used the Grid Lines toggle in the default toolbars (Set GRIDLINESH=toggle) to override the grid line settings in Preferences, then used it again to go back to normal, that lister would then ignore changes to grid lines Preferences. The second toggle will now reset the lister back to the current Preferences settings, and it will then track them as normal.
  • Fixes for 12.7.2 beta grid-line changes, particularly with full-row selection. Additionally, when not grouping, we now draw a grid line before the first file and after the last file, and alternating bars begin on the first file instead of the second, to better suit Windows 10's column header aesthetics.
  • Fixes for thumbnail painting issues introduced in 12.7.2 beta.

Column - Custom Text and Regexp