allow browse_directory to be called without opening the browser

Author: CogentRedTester

docs/addons.md

@@ -443,9 +443,12 @@ The current API version in use by file-browser.
 
 Adds the given extension to the default extension filter whitelist. Can only be run inside the `setup()` method.
 
-#### `fb.browse_directory(directory: string): void`
+#### `fb.browse_directory(directory: string, open_browser: bool = true): void`
 
-Clears the cache and opens the given directory in the browser. If the browser is closed then it will be opened.
+Clears the cache and opens the given directory in the browser.
+If the `open_browser` argument is truthy or `nil` then the browser will be opened
+if it is currently closed. If `open_browser` is `false` then the directory will
+be opened in the background.
 This function is non-blocking, it is possible that the function will return before the directory has finished
 being scanned.
 

modules/controls.lua

@@ -71,8 +71,10 @@ function controls.escape()
 end
 
 --opens a specific directory
-function controls.browse_directory(directory)
+function controls.browse_directory(directory, open_browser)
     if not directory then return end
+    if open_browser == nil then open_browser = true end
+
     directory = mp.command_native({"expand-path", directory}) or ''
     -- directory = join_path( mp.get_property("working-directory", ""), directory )
 
@@ -81,7 +83,7 @@ function controls.browse_directory(directory)
 
     directory = fb_utils.resolve_directory_mapping(directory)
     movement.goto_directory(directory)
-    controls.open()
+    if open_browser then controls.open() end
 end
 
 return controls