sanity-plugin-mux-input
Advanced tools
An input component that integrates Sanity Studio with Mux video encoding/hosting service.
This is a Sanity Studio v3 plugin. For the v2 version, please refer to the v2-branch.
This is a plugin that let you use Mux video assets in your Sanity studio.
The Mux plugin for Sanity gives you a way to upload and preview videos easily.
Read our blog post about this plugin.
Not familiar with Sanity? Visit www.sanity.io
npm install --save-exact sanity-plugin-mux-input
or
yarn add --exact sanity-plugin-mux-input
npm i sanity-plugin-mux-input@studio-v3.
Read more about using plugins in Sanity here.Make a schema type that uses the plugin's type mux.video, for example:
export default {
title: 'Video blog post',
name: 'videoBlogPost',
type: 'document',
fields: [
{title: 'Title', name: 'title', type: 'string'},
{
title: 'Video file',
name: 'video',
type: 'mux.video',
},
],
}
muxInput import to your plugins:import {defineConfig} from 'sanity'
import {muxInput} from 'sanity-plugin-mux-input'
export default defineConfig({
plugins: [muxInput()],
})
Read more about schemas in Sanity here.
The Mux Video API uses an Access Token and Secret Key for authentication.
If you haven't already, generate a new Access Token in the Access Token settings of your Mux account dashboard, and make sure it got permission to both read and write video and read data.
The token is stored in the dataset as a document of the type mux.apiKey with the id secrets.mux.
Having the ID be non-root ensures that only editors are able to see it.
The Mux plugin will find its access tokens by fetching this document.
We recommend using Mux Player, try the Codesandbox example.
To enable signed urls with content uploaded to Mux, you will need to check the "Enable Signed Urls" option in the Mux Plugin configuration. Assuming that the API Access Token and Secret Key are set (as per the Quick start section).
More information for this feature of the plugin can be found on Mux's documentation
To enable static MP4 renditions, add mp4_support: 'standard' to the options of your mux.video schema type.
import {muxInput} from 'sanity-plugin-mux-input'
export default defineConfig({
plugins: [muxInput({mp4_support: 'standard'})],
})
Currently, mp4_support is the only supported MUX option and this supports a value of either standard or none (the default).
Issues are actively monitored and PRs are welcome. When developing this plugin the easiest setup is:
npm create sanity@dev-preview. Follow the prompts, starting out with the blog template is a good way to go.cd into your project directory, run npm install && npm start - your sanity studio should be running on http://localhost:3333.cd into the plugins directory of your project.plugins directory inside your project git clone git@github.com:your-fork/sanity-plugin-mux-input.git.sanity.json, go to the plugins array and add mux-input.npm start.schemas/post.js and add follow the plugin documentation to add a mux.video type field.Run the "CI" workflow. Make sure to select the main branch and check "Release new version".
Semantic release will only release on configured branches, so it is safe to run release on any branch.
On the studio-v2 branch this will result in:
latest dist-tag.yarn add sanity-plugin-mux-input or npm i sanity-plugin-mux-input will fetch the new version.sanity install mux-input will fetch the new version.On the main branch this will result in:
studio-v3 dist-tag.yarn add sanity-plugin-mux-input@studio-v3 or npm i sanity-plugin-mux-input@studio-v3 will fetch the new version.sanity install mux-input won't fetch the new version.After Studio v3 turns stable this behavior will change. The v2 version will then be available on the studio-v2 dist-tag, and studio-v3 is upgraded to live on latest.
npm test
MIT-licensed. See LICENSE.
This plugin uses @sanity/plugin-kit with default configuration for build & watch scripts.
See Testing a plugin in Sanity Studio on how to run this plugin with hotreload in the studio.
Run "CI & Release" workflow. Make sure to select the main branch and check "Release new version".
Semantic release will only release on configured branches, so it is safe to run release on any branch.
2.0.0 (2022-11-17)
@sanity/ui is a normal dependency, not a peer dependency (7cf3c8e)@sanity/ui (76f59f1)cdn.skypack.dev workaround (1d5f2c2)dev-preview.21 and later (387e2f1)FAQs
An input component that integrates Sanity Studio with Mux video encoding/hosting service.
The npm package sanity-plugin-mux-input receives a total of 6,910 weekly downloads. As such, sanity-plugin-mux-input popularity was classified as popular.
We found that sanity-plugin-mux-input demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 64 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.
Security News
PyPI now supports digital attestations, enhancing security and trust by allowing package maintainers to verify the authenticity of Python packages.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.