Home
Docs
Blog
Articles
Home
Docs
Blog
Articles
Extensions
Welcome What's new in Chrome extensions Get help with Chrome extensions
Welcome Extensions 101 Development basics Run scripts on every page Inject scripts into the active tab Manage tabs
Welcome to Manifest V3 Extensions platform vision Overview of Manifest V3
What are themes? Frequently asked questions Extensions quality guidelines FAQ
Migrate to Manifest V3 Manifest V3 migration checklist Update the manifest Migrate to a service worker Update your code Replace blocking web request listeners Improve extension security Manifest V2 support timeline Known issues when migrating to Manifest V3
API reference Samples
Extension development overview Manifest file format Architecture overview Declare permissions Design the user interface Debugging extensions Samples
Message passing Content scripts Manage events with service workers Match patterns Using promises Cross-origin isolation
Cross-origin XMLHttpRequest Using eval in Chrome extensions
Overriding Chrome settings Extending DevTools Fetching favicons OAuth2: Authenticate users with Google Overriding Chrome pages Rich notifications API Native messaging
Protect user privacy Declare permissions and warn users Stay secure Accessibility (a11y) Localization message formats Give users options
Extension hosting Alternative extension installation methods Installing extensions on Linux Tutorial: Google analytics
About Manifest V2 Getting started
What are extensions? What are themes? Frequently asked questions
Extension development overview Manifest file format Architecture overview Declare permissions Design the user interface Debugging extensions Samples
Message passing Content scripts Manage events with background scripts Match patterns Cross-origin isolation
Cross-origin XMLHttpRequest Using eval in Chrome extensions
Overriding Chrome settings Extending DevTools OAuth2: Authenticate users with Google Overriding Chrome pages Rich notifications API
Protect user privacy Declare permissions and warn users Stay secure Accessibility (a11y) Localization message formats Give users options
Chrome Web Store Alternative extension distribution options Installing extensions on Linux Tutorial: Google analytics
Extensions
Welcome What's new in Chrome extensions Get help with Chrome extensions
Welcome Extensions 101 Development basics Run scripts on every page Inject scripts into the active tab Manage tabs
Welcome to Manifest V3 Extensions platform vision Overview of Manifest V3
What are themes? Frequently asked questions Extensions quality guidelines FAQ
Migrate to Manifest V3 Manifest V3 migration checklist Update the manifest Migrate to a service worker Update your code Replace blocking web request listeners Improve extension security Manifest V2 support timeline Known issues when migrating to Manifest V3
API reference Samples
Extension development overview Manifest file format Architecture overview Declare permissions Design the user interface Debugging extensions Samples
Message passing Content scripts Manage events with service workers Match patterns Using promises Cross-origin isolation
Cross-origin XMLHttpRequest Using eval in Chrome extensions
Overriding Chrome settings Extending DevTools Fetching favicons OAuth2: Authenticate users with Google Overriding Chrome pages Rich notifications API Native messaging
Protect user privacy Declare permissions and warn users Stay secure Accessibility (a11y) Localization message formats Give users options
Extension hosting Alternative extension installation methods Installing extensions on Linux Tutorial: Google analytics
About Manifest V2 Getting started
What are extensions? What are themes? Frequently asked questions
Extension development overview Manifest file format Architecture overview Declare permissions Design the user interface Debugging extensions Samples
Message passing Content scripts Manage events with background scripts Match patterns Cross-origin isolation
Cross-origin XMLHttpRequest Using eval in Chrome extensions
Overriding Chrome settings Extending DevTools OAuth2: Authenticate users with Google Overriding Chrome pages Rich notifications API
Protect user privacy Declare permissions and warn users Stay secure Accessibility (a11y) Localization message formats Give users options
Chrome Web Store Alternative extension distribution options Installing extensions on Linux Tutorial: Google analytics

chrome.mediaGalleries

This API is part of the deprecated Chrome Apps platform. Learn more about migrating your app.
  • Description

    Use the chrome.mediaGalleries API to access media files (audio, images, video) from the user's local disks (with the user's consent).

  • Permissions
    mediaGalleries

Summary

Types

AddGalleryWatchResult

Properties

  • galleryId

    string

  • success

    boolean

GalleryChangeDetails

Properties

  • galleryId

    string

    Identifies the modified gallery.

  • Type of change event.

GalleryChangeType

Type

"contents_changed"

, or

"watch_dropped"

GetMediaFileSystemsInteractivity

Type

"no"

,

"yes"

, or

"if_needed"

GetMetadataType

Type

"all"

,

"mimeTypeAndTags"

, or

"mimeTypeOnly"

MediaFileSystemMetadata

Properties

  • deviceId

    string optional

    If the media gallery is on a removable device, a unique id for the device while the device is online.

  • galleryId

    string

    A unique and persistent id for the media gallery.

  • isAvailable

    boolean

    True if the device is currently available.

  • isMediaDevice

    boolean

    True if the device the media gallery is on was detected as a media device. i.e. a PTP or MTP device, or a DCIM directory is present.

  • isRemovable

    boolean

    True if the media gallery is on a removable device.

  • name

    string

    The name of the file system.

MediaFileSystemsDetails

Properties

  • Whether to prompt the user for permission to additional media galleries before returning the permitted set. Default is silent. If the value 'yes' is passed, or if the application has not been granted access to any media galleries and the value 'if_needed' is passed, then the media gallery configuration dialog will be displayed.

MediaMetadata

Properties

  • album

    string optional

    Defined for audio and video.

  • artist

    string optional

  • attachedImages

    Blob[]

    The images embedded in the media file's metadata. This is most often used for album art or video thumbnails.

  • comment

    string optional

  • copyright

    string optional

  • disc

    number optional

  • duration

    number optional

    Defined for audio and video. In seconds.

  • genre

    string optional

  • height

    number optional

    Defined for video. In pixels.

  • language

    string optional

  • mimeType

    string

    The browser sniffed mime type.

  • rawTags

    StreamInfo[]

    All the metadata in the media file. For formats with multiple streams, stream order will be preserved. Container metadata is the first element.

  • rotation

    number optional

    Defined for video. In degrees.

  • title

    string optional

  • track

    number optional

  • width

    number optional

MediaMetadataOptions

Properties

  • metadataType

    GetMetadataType optional

    Specifies which subset of the metadata to retrieve. Defaults to 'all' if the option is omitted.

StreamInfo

Properties

  • tags

    object

    An unfiltered string->string dictionary of tags for the stream.

  • type

    string

    Describes format of container or codec of stream, i.e. "mp3", "h264".

Methods

addGalleryWatch

chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback: function,
)

Adds a gallery watch for the gallery with the specified gallery ID. The given callback is then fired with a success or failure result.

Parameters

addUserSelectedFolder

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Present a directory picker to the user and add the selected directory as a gallery. If the user cancels the picker, selectedFileSystemName will be empty. A user gesture is required for the dialog to display. Without a user gesture, the callback will run as though the user canceled.

Parameters

  • callback

    function

    The callback parameter looks like: (mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      string

getMediaFileSystemMetadata

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

Get metadata about a specific media file system.

Parameters

  • mediaFileSystem

    DOMFileSystem

Returns

getMediaFileSystems

chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback: function,
)

Get the media galleries configured in this user agent. If none are configured or available, the callback will receive an empty array.

Parameters

  • details

    MediaFileSystemsDetails optional

  • callback

    function

    The callback parameter looks like: (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

getMetadata

chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback: function,
)

Gets the media-specific metadata for a media file. This should work for files in media galleries as well as other DOM filesystems.

Parameters

removeGalleryWatch

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

Removes a gallery watch for the gallery with the specified gallery ID.

Parameters

  • galleryId

    string

Events

onGalleryChanged

chrome.mediaGalleries.onGalleryChanged.addListener(
  callback: function,
)

Fired when a media gallery is changed or a gallery watch is dropped.

Parameters

We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.
More details