Skip to main content

Migrating from Mux

Migrating from Mux to HesedVid

This guide helps you migrate your video infrastructure from Mux to HesedVid with minimal disruption to your service.

Tip

Most migrations can be completed in phases over 2-4 weeks, allowing you to test thoroughly before switching completely.

Migration Overview

  • Compare APIs: Map Mux endpoints to HesedVid equivalents

  • Update authentication: Switch from Mux API tokens to HesedVid API keys

  • Modify upload flow: Adapt your upload process

  • Update players: Point to new playback URLs

  • Migrate analytics: Transition tracking and reporting

  • API Comparison

    Core Endpoints

    Mux EndpointHesedVid EquivalentNotes
    POST /video/v1/assetsTwo-step process:
    1. POST /{orgID}/environments/{envID}/videos/upload-url
    2. POST /{orgID}/environments/{envID}/videos/process
    HesedVid separates upload and processing
    POST /video/v1/uploadsPOST /{orgID}/environments/{envID}/videos/upload-urlDirect upload to storage
    GET /video/v1/assets/{id}GET /{orgID}/videos/{publicID}/detailsSimilar response structure
    DELETE /video/v1/assets/{id}DELETE /{orgID}/videos/{videoID}Soft delete with cleanup
    GET /data/v1/metricsGET /{orgID}/analytics/*Multiple specialized endpoints

    Playback URLs

    Code Migration Examples

    Upload Flow

    Status Polling

    Both platforms require polling for processing status:

    Feature Mapping

    Video Processing

    Mux FeatureHesedVid EquivalentConfiguration
    Encoding TiersVideo Qualitystandard, high, ultra
    MP4 SupportComing SoonHLS-only currently
    ThumbnailsCustom ThumbnailsGenerate at any timestamp
    CaptionsComing SoonQ2 2024
    ClippingComing SoonQ3 2024
    Live StreamingNot AvailableFocus on VOD

    Analytics

    Mux DataHesedVid AnalyticsEndpoint
    ViewsSegments ServedGET /analytics/usage
    View DurationSegments × 6sCalculate from segments
    Unique ViewersNot AvailablePrivacy-focused
    Quality DistributionResolution AnalyticsGET /analytics/resolution
    ErrorsNot AvailableClient-side only

    Migration Checklist

  • Set up HesedVid account

    • Create organization
    • Generate API keys
    • Configure billing
  • Update backend code

    • Replace Mux SDK with HesedVid API calls
    • Update webhook handlers
    • Modify upload flow
  • Update frontend

    • Switch playback URLs
    • Update player configuration
    • Test on all platforms
  • Migrate content (optional)

    • Export video list from Mux
    • Re-upload to HesedVid
    • Update video IDs in database
  • Monitor and optimize

    • Compare analytics
    • Adjust encoding settings
    • Monitor costs
  • Cost Comparison

    Tip

    HesedVid typically costs 70-80% less than Mux for similar usage patterns.

    Pricing Example (10,000 minutes/month)

    ServiceEncodingStorageDeliveryTotal
    Mux$50$25$125$200
    HesedVidIncludedIncluded$0.15/min$150

    Savings: $50/month (25%)

    Common Issues

    CORS Errors

    HesedVid has permissive CORS by default. No configuration needed.

    Webhook Differences

    Mux sends many granular events. HesedVid focuses on key events:

    // Webhook handler
    app.post('/webhooks/hesedvid', (req, res) => {
    const { event, videoId, status } = req.body;
    switch(event) {
    case 'video.processing.completed':
    // Video ready
    break;
    case 'video.processing.failed':
    // Handle error
    break;
    }
    });

    Player Compatibility

    HesedVid uses standard HLS. Any HLS player works:

    • HLS.js
    • Video.js
    • Native Safari
    • ExoPlayer (Android)
    • AVPlayer (iOS)

    Support

    Need help migrating?

    Note

    Enterprise customers get free migration assistance including code review and implementation support.