Skip to content

FEATURE - Filesystem plugin browser #198

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
richardssam wants to merge 58 commits into
base: main
Choose a base branch
from
Open

FEATURE - Filesystem plugin browser #198

richardssam wants to merge 58 commits into from

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 28 commits December 18, 2025 10:52
@tedwaine
Fix Win namespace issue
d1bc1d1
@tedwaine
Sync to DNEG internal
5f224e8
@tedwaine
Clang format
ea9e487
@tedwaine
Tweak media reader precedence
8654cc1
@HughMacdonald
fix: Use platform-specific path separators for XSTUDIO_PLUGIN_PATH.
e04f89f 
Signed-off-by: Hugh Macdonald <hugh@hughmacdonald.co.uk>
@tedwaine
Merge pull request AcademySoftwareFoundation#189 from HughMacdonald/f…
7c28227 
…ix-windows-plugin-path

AcademySoftwareFoundation#188: Fix environment variable path separator on Windows
@tedwaine
Fix slow media loading into large playlists and timelines
0b1c0b0
@richardssam
A ffmpeg constant changed, I believe the older one FF_PROFILE_UNKOWN …
665c8e1 
…has been obsolete for a while.

Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Switch to ffmpeg 8.0.1
26c02ea
@richardssam
Initial checkin of filesystem_plugin prior to refactor.
25953c1 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Merge branch 'ffmpeg8' into filesystem_plugin
0403a0a
@richardssam
Cleanup GUI
27ddee9 
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.
1ae4bad 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Got the progress bar to work correctly.
088af70 
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.
d0dc72c 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Add readme.
2ee55f5 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Adding copyright/license info.
8174159 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Adding (c).
50d0ed2 
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…
8503b60 
…r so.
@richardssam
Swapped file-browser with a history view.
9ba2f2b
@richardssam
Updated readme.
057000d
@richardssam
Fixing QML issue.
0686835 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Demo of widget as a floating window.
a188311 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Filtering fixes.
ad2b310 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Switched to a tree-view with some "smart" collapsing of directories.
6ae4495 
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.
2487de1 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Double clicking on a directory changes the overall search window path.
9813f94 
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
@richardssam
Make the search case insensitive.
a0cd3e9 
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