anki-connect/actions/media.md

Media Actions

• storeMediaFile

  Stores a file with the specified base64-encoded contents inside the media folder. alternatively you can specify a url from where the file shell be downloaded. If both field data and url are provided, the data field will be used. To prevent Anki from removing files not used by any cards (e.g. for configuration files), prefix the filename with an underscore. These files are still synchronized to AnkiWeb.

  Sample request:

  {
      "action": "storeMediaFile",
      "version": 6,
      "params": {
          "filename": "_hello.txt",
          "data": "SGVsbG8sIHdvcmxkIQ=="
      }
  }
  

  Sample result:

  {
      "result": null,
      "error": null
  }
  

  Content of _hello.txt:

  Hello world!
  

  Sample request:

  {
      "action": "storeMediaFile",
      "version": 6,
      "params": {
          "filename": "_hello.txt",
          "url": "https://url.to.file"
      }
  }
  

  Sample result:

  {
      "result": null,
      "error": null
  }
  

• retrieveMediaFile

  Retrieves the base64-encoded contents of the specified file, returning false if the file does not exist.

  Sample request:

  {
      "action": "retrieveMediaFile",
      "version": 6,
      "params": {
          "filename": "_hello.txt"
      }
  }
  

  Sample result:

  {
      "result": "SGVsbG8sIHdvcmxkIQ==",
      "error": null
  }
  

• deleteMediaFile

  Deletes the specified file inside the media folder.

  Sample request:

  {
      "action": "deleteMediaFile",
      "version": 6,
      "params": {
          "filename": "_hello.txt"
      }
  }
  

  Sample result:

  {
      "result": null,
      "error": null
  }