AcademySoftwareFoundation
diff --git a/‎CMakeLists.txt‎
Lines changed: 1 addition & 1 deletion b/‎CMakeLists.txt‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎src/plugin/media_metadata/ffprobe/src/ffprobe_lib.cpp‎
Lines changed: 1 addition & 1 deletion b/‎src/plugin/media_metadata/ffprobe/src/ffprobe_lib.cpp‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎src/plugin/python_plugins/filesystem_browser/README.md‎
Lines changed: 68 additions & 0 deletions b/‎src/plugin/python_plugins/filesystem_browser/README.md‎
Lines changed: 68 additions & 0 deletions
diff --git a/‎src/plugin/python_plugins/filesystem_browser/__init__.py‎
Lines changed: 1 addition & 0 deletions b/‎src/plugin/python_plugins/filesystem_browser/__init__.py‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎src/plugin/python_plugins/filesystem_browser/config.json‎
Lines changed: 42 additions & 0 deletions b/‎src/plugin/python_plugins/filesystem_browser/config.json‎
Lines changed: 42 additions & 0 deletions
@@ -208,7 +208,7 @@ if (USE_VCPKG)
     message(FATAL_ERROR "Failed to ensurepip.")
   else()
     execute_process(
-      COMMAND "${Python_EXECUTABLE}" -m pip install setuptools sphinx breathe sphinx-rtd-theme OpenTimelineIO-Plugins importlib_metadata zipp numpy
+      COMMAND "${Python_EXECUTABLE}" -m pip install setuptools sphinx breathe sphinx-rtd-theme OpenTimelineIO-Plugins importlib_metadata zipp numpy fileseq
       RESULT_VARIABLE PIP_RESULT
     )
     if(PIP_RESULT)
 
@@ -444,7 +444,7 @@ nlohmann::json populate_stream(AVFormatContext *avfc, int index, MediaStream *is
     result["profile"] = nullptr;
     if (profile = avcodec_profile_name(par->codec_id, par->profile))
         result["profile"] = profile;
-    else if (par->profile != FF_PROFILE_UNKNOWN) {
+    else if (par->profile != AV_PROFILE_UNKNOWN) {
         result["profile"] = std::to_string(par->profile);
     }
 
 
@@ -0,0 +1,68 @@
+# Filesystem Browser Plugin for xStudio
+
+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.
+    - **Double-click** a folder to navigate into it.
+    - **Quick Access (▼)**: Click the arrow next to the path field to open the Quick Access list.
+      - **History**: Shows recently visited directories.
+      - **Pinned**: Shows your pinned locations for easy access.
+      - **Pinning**: Click the "Pin" icon (📌) next to any item to pin or unpin it. Pinned items appear at the top in gold.
+
+## Configuration
+
+### Environment Variables
+
+- `XSTUDIO_BROWSER_PINS`: Pre-define a list of pinned directories.
+  - Format: JSON list of objects or simple path string (colon-separated on Unix, semicolon on Windows).
+  - Example (JSON): `'[{"name": "Show", "path": "/jobs/show"}, "/home/user"]'`
+  - Example (Simple): `/jobs/show:/home/user`
+
+3.  **Loading Media**:
+    - **Double-click** a file/sequence to load it into the current or new playlist.
+    - **Right-click** for advanced actions (Replace, Compare).
+
+## Logic & Performance
+
+- **Scanning**: The scanner runs in a background thread, reporting partial results to the UI to keep it responsive. 
+- **Sequences**: Uses the `fileseq` library (for robust sequence parsing.
+
+## Testing
+
+A benchmark script is included to test the scanner performance:
+
+```bash
+python scanner_benchmark.py --threads 2 /shots/MYSHOW/MYSHOT
+```
+
+This allows you to test the scanning performance at different thread speeds for the specified directory.
+
+```bash
+python test_scanner.py
+```
+Unit test for scanner.
+
@@ -0,0 +1 @@
+from .filesystem_browser import create_plugin_instance
@@ -0,0 +1,42 @@
+{
+    "extensions": [
+        ".mov",
+        ".mp4",
+        ".mkv",
+        ".exr",
+        ".jpg",
+        ".jpeg",
+        ".png",
+        ".dpx",
+        ".tiff",
+        ".tif",
+        ".wav",
+        ".mp3",
+        ".pdf"
+    ],
+    "ignore_dirs": [
+        ".git",
+        ".quarantine",
+        "eryx_unreal_plugin",
+        ".DS_Store"
+    ],
+    "root_ignore_dirs": [
+        "/Applications",
+        "/bin",
+        "/cores",
+        "/dev",
+        "/etc",
+        "/Library",
+        "/opt",
+        "/private",
+        "/sbin",
+        "/System",
+        "/usr",
+        "/var",
+        "/proc",
+        "/sys",
+        "/snap"
+    ],
+    "max_recursion_depth": 6,
+    "auto_scan_threshold": 4
+}
Original file line number	Diff line number	Diff line change
`@@ -208,7 +208,7 @@ if (USE_VCPKG)`
`208`	`208`	`message(FATAL_ERROR "Failed to ensurepip.")`
`209`	`209`	`else()`
`210`	`210`	`execute_process(`
`211`		`- COMMAND "${Python_EXECUTABLE}" -m pip install setuptools sphinx breathe sphinx-rtd-theme OpenTimelineIO-Plugins importlib_metadata zipp numpy`
	`211`	`+ COMMAND "${Python_EXECUTABLE}" -m pip install setuptools sphinx breathe sphinx-rtd-theme OpenTimelineIO-Plugins importlib_metadata zipp numpy fileseq`
`212`	`212`	`RESULT_VARIABLE PIP_RESULT`
`213`	`213`	`)`
`214`	`214`	`if(PIP_RESULT)`
Original file line number	Diff line number	Diff line change
`@@ -444,7 +444,7 @@ nlohmann::json populate_stream(AVFormatContext avfc, int index, MediaStream is`
`444`	`444`	`result["profile"] = nullptr;`
`445`	`445`	`if (profile = avcodec_profile_name(par->codec_id, par->profile))`
`446`	`446`	`result["profile"] = profile;`
`447`		`- else if (par->profile != FF_PROFILE_UNKNOWN) {`
	`447`	`+ else if (par->profile != AV_PROFILE_UNKNOWN) {`
`448`	`448`	`result["profile"] = std::to_string(par->profile);`
`449`	`449`	`}`
`450`	`450`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+from .filesystem_browser import create_plugin_instance`