Skip to content

FEATURE - Filesystem plugin browser#198

Open
richardssam wants to merge 67 commits intoAcademySoftwareFoundation:mainfrom
richardssam:filesystem_plugin
Open

FEATURE - Filesystem plugin browser#198
richardssam wants to merge 67 commits intoAcademySoftwareFoundation:mainfrom
richardssam:filesystem_plugin

Conversation

@richardssam
Copy link
Contributor

@richardssam richardssam commented Jan 29, 2026

Filesystem plugin browser

A high-performance, multi-threaded filesystem browser for xStudio, designed to handle large directories and image sequences efficiently.

Features

  • Fast Multi-threaded Scanning: Uses a thread pool and BFS algorithm to scan directories quickly without freezing the UI.
  • Image Sequence Detection: Automatically detects and groups file sequences (e.g., shot_001.1001.exr -> shot_001.####.exr). Supports exclusion of specific extensions (e.g., .mov, .mp4) via configuration.
  • Smart Filtering:
    • Text Filter: Supports "AND" logic (space-separated terms). E.g., comp exr finds files matchings both "comp" and "exr".
    • Time Filter: Filter by modification time (Last 1 day, 1 week, etc.).
    • Version Filter: Filter to show only the latest version or latest 2 versions of a shot.
  • Navigation:
    • Native Directory Picker integration.
    • Path completion/suggestions.
    • History tracking (via sticky attributes).
  • Playback Integration:
    • Double-Click: Loads media and immediately starts playback using the playlist's playhead logic.
    • Context Menu:
      • Replace: Replaces the currently viewed media with the selected item.
      • Compare with: Loads the selected item and sets up an A/B comparison with the current media.

Usage

  1. Open the Browser:
    • Go to View -> Panels -> Filesystem Browser.
    • Or use the hotkey 'B'.
  2. Navigation:
    • Enter a path in the text field or click the folder icon to browse.
  3. Loading Media:
    • Double-click a file/sequence to load it into the current or new playlist.
    • Right-click for advanced actions (Replace, Compare).
image

kenmcgaugh and others added 30 commits November 26, 2025 06:40
@kenmcgaugh
Add remove_media_source_atom and associated handler to media_actor.
0b01397 
Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Added missing override keyword to avoid compiler warning.
883e334 
Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Fixed typo in show_viewer_hotkey text.
acfc5c9 
Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Small fixes to avoid benign QML warnings.
c5388c1 
Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Allow udta metadata tags to be passed through.
9539d3a 
Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Fixed incorrect keycode for MetaModifier.
c6a72ef 
Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Fixed missing parentheses reported by compiler. This now matches the …
88861dd 
…annotation_serialiser.cpp.

Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Exposed additional methods and constructors for MediaReference, Frame…
a74145b 
…List, and Timecode.

Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Exposse the AltModifier to python, which was the one modifier missing.
734d717 
Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Change to prevent sources provided by non-file URL schemes to be mark…
fa32aa1 
…ed as MS_MISSING. This allows for media_sources to be provided by http(s).

Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
This MacOS-only fix prevents an "stroull" error message when a .DS_St…
8da45af 
…ore file exists in a thumbnail cache directory.

Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Added empty event_atom/name_atom message handler to prevent error mes…
c2556ca 
…sage.

Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Modified OCIOEngine::get_ocio_config() to pass the "ocio_config" meta…
e6d277d 
…data value through xstudio's file-path remapping mechanism. Likewise, all the search paths within the config are also passed through file path remapping.

Note that any path set via the OCIO environment variable is left as-is.

Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Modifications to allow the "working_space" be set via the source colo…
2fde4fd 
…ur management metadata. We use this to set the working_space to "raw" for media we want to remain unmanaged but still allow for the global view to be set without causing error messages.

Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
This adds hotkeys for changing the current OCIO view. The hotkeys are…
92d9289 
… Ctrl+1 through Ctrl+9 (linux) and each select the the corresponding view for the current display. Under MacOS these are Cmd+1 through Cmd+9.

Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Just a couple of typos corrected.
58d0915 
Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@kenmcgaugh
Allow for optionally disabling SSL verification.
b43b188 
Signed-off-by: Ken McGaugh <ken@mcgaugh.co.uk>
@tedwaine
Remove empty parent menus when menu item is deleted.
6c1c12c
@Blackhart
Implement OIIO reader
30c6efc 
Signed-off-by: Thomas Manceau <manceau.thomas19@gmail.com>
@Blackhart
Add OIIO metadata
9b84190 
Signed-off-by: Thomas Manceau <manceau.thomas19@gmail.com>
@Blackhart
Change openimageio version in vcpkg.json
bf1829e 
Updated version of openimageio from 2.5.19.1 to 2.5.16.0#1.

Signed-off-by: Thomas Manceau <manceau.thomas19@gmail.com>
@tedwaine
Merge pull request AcademySoftwareFoundation#171 from Blackhart/featu…
469f404 
…re/implement-oiio-reader

AcademySoftwareFoundation#98: Open Image IO Library / Reader
@tedwaine
Merge pull request AcademySoftwareFoundation#178 from kenmcgaugh/feat…
180de28 
…ure_remove_media_sources

Add ability to programatically remove media_source's from media items.
@tedwaine
Merge pull request AcademySoftwareFoundation#180 from kenmcgaugh/misc…
47f6713 
…_fixes_additions

Miscellaneous fixes and additions
@tedwaine
Merge pull request AcademySoftwareFoundation#181 from kenmcgaugh/misc…
e4e48f6 
…_cosmetic_fixes

Misc cosmetic fixes
@tedwaine
Merge pull request AcademySoftwareFoundation#182 from kenmcgaugh/ocio…
92487c6 
…_additions

OCIO view hotkeys, working_space, and file-path remapping
@tedwaine
Merge pull request AcademySoftwareFoundation#185 from kenmcgaugh/feat…
c566cab 
…ure_disable_http_ssl_verify

Allow for optionally disabling SSL verification.
@tedwaine
Sync with latest DNEG internal repo
98a8aef
@tedwaine
Re-instate OTIO submodule
32967af
@tedwaine
Fix merge problems
fb4db37
tedwaine and others added 26 commits February 2, 2026 11:28
@tedwaine
Sync to DNEG internal repo
6c496b1 
Signed-off-by: Ted Waine <ted.waine@gmail.com>
@tedwaine
Merge pull request AcademySoftwareFoundation#200 from tedwaine/develop
e652306 
Sync to DNEG internal repo
@tedwaine
Merge pull request AcademySoftwareFoundation#192 from kenmcgaugh/impo…
d45d24c 
…rt_timeline_uri

Added support for specifying timelines to import via custom URI
@richardssam
Initial checkin of filesystem_plugin prior to refactor.
a8c8eb0 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
A ffmpeg constant changed, I believe the older one FF_PROFILE_UNKOWN …
93e1b68 
…has been obsolete for a while.

Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Switch to ffmpeg 8.0.1
2eefb73
@richardssam
Cleanup GUI
aba1dcb 
Better filtering, got progress bar working, and version and date filtering.

Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Adding fileseq for the python libraries for the FileSystem Browser.
334c04e 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Got the progress bar to work correctly.
8c58d31 
Also added a separate timing test where you can specify an output directory, not really for unit testing, but good for testing against real directories.

Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Fix for color scheme for right click menu.
9524646 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Add readme.
9f0cc7e 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Adding copyright/license info.
4fcfab8 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Adding (c).
51fc669 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Dont be quite so agressive updating the UI, only do it every 5 secs o…
0d41f13 
…r so.
@richardssam
Swapped file-browser with a history view.
f662824
@richardssam
Updated readme.
1fb1b8f
@richardssam
Fixing QML issue.
f1468eb 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Demo of widget as a floating window.
bce718a 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Filtering fixes.
7d8e65c 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Switched to a tree-view with some "smart" collapsing of directories.
6a7f9e8 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Fixed the file-loading issue, it was trying to load a relative path.
d4253b3 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Double clicking on a directory changes the overall search window path.
b0c2234 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Make the search case insensitive.
95f6049 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Adding different types of tree view. and recursion depths.
d89383d 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Minor tweak to prune empty folders if we are filtering.
0a683ca 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Adding a directory view.
6e7123a 
The directory view allows a more obvious browsing of the tree. For the very top of the directory tree we dont auto-scan for media, once you get down to 4 levels it will start scanning.
We have also made a config.json file to store configurations of things like the auto_scan_threashold, along with adding a list of folders that need to be ignored.

Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Filtering all the time.
c23565f 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
GUI update:
93d03af 
   * Fixed auto-complete
   * Tree view opens to node when path is entered in path dialog.
   * Added a refresh button
   * Tree view now persistent, with a nicer sidebar label.
   * Smart scan button now visible.

Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Added a preview mode, so when you click on a clip, it will automatica…
eba2367 
…lly load it into the player

   * double click will load it into your target
   * Cursor keys will allow you to move through the results loading as you go (left right for icon view, up down for list view)
   * Enter will do the same as double click.
   * Preview playlist will be deleted on Enter.

Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@richardssam @kenmcgaugh @tedwaine @Blackhart @HughMacdonald