add a new action: getMediaDirPath

README.md

@@ -1759,6 +1759,32 @@ corresponding to when the API was available for use.
     ```
     </details>
 
+#### `getMediaDirPath`
+
+*   Gets the full path to the `collection.media` folder of the currently opened profile.
+
+    <details>
+    <summary><i>Sample request:</i></summary>
+
+    ```json
+    {
+        "action": "getMediaDirPath",
+        "version": 6
+    }
+    ```
+    </details>
+
+    <details>
+    <summary><i>Sample result:</i></summary>
+
+    ```json
+    {
+        "result": "/home/user/.local/share/Anki2/Main/collection.media",
+        "error": null
+    }
+    ```
+    </details>
+
 #### `deleteMediaFile`
 
 *   Deletes the specified file inside the media folder.

plugin/__init__.py

@@ -722,6 +722,9 @@ class AnkiConnect:
         except AttributeError:
             self.media().trash_files([filename])
 
+    @util.api()
+    def getMediaDirPath(self):
+        return os.path.abspath(self.media().dir())
 
     @util.api()
     def addNote(self, note):