If YouTube reports an unsupported codec when you send a prerecorded file through GStreamer, first check which YouTube ingest protocol you selected and where the rejection occurs. For an RTMP or RTMPS stream, a common conversion path is to decode the file, encode video as H.264 and audio as AAC, mux the result as FLV, and send it to YouTube. That is a starting point—not proof that the codec is the cause of every failure.
Check the protocol before changing codecs
YouTube’s encoder guidance is protocol-dependent. For RTMP/RTMPS, it lists H.264, H.265/HEVC and AV1 video, with AAC or MP3 audio; YouTube recommends RTMPS. Confirm the current requirements for your stream mode in YouTube’s live encoder settings guidance. A message that says “unsupported codec” does not, by itself, reveal whether YouTube rejected the selected output, GStreamer failed to negotiate caps, or a local decoder or plugin is missing.
YouTube also documents HLS ingestion for codecs not supported by RTMP and for HDR workflows. HLS is a different ingest workflow: changing a codec in an RTMP/FLV pipeline does not turn it into HLS. See YouTube’s HLS setup guidance if that protocol fits your source and sender.
Use this RTMP/RTMPS conversion pipeline as a starting point
The format flow is: prerecorded file → demux and decode → raw audio/video → convert → encode for the selected ingest protocol → mux → network sink. GStreamer’s tutorial demonstrates this general software-transcoding approach. The example below uses H.264, AAC, FLV, and RTMPS:
#1 Best Overall
- AV TO USB Converter: Capture videos and audios from VHS, VCR, Hi8, DV tapes to a PC, with the help of our USB Video Converter. Save room while digitizing your favorite old memories
- Quality Capture Card: Our USB Video Capture Card converting anolog RCA composite input into HD 720P USB output and capturing audio without any sound card. Advanced signal processing technology provides you with great precision, colors, resolutions, and details.
- Plug and Play: Automatically install the driver once you hook up this RCA to USB Converter to a PC. No external power is needed. User-friendly and easy to operate
- Wide Compatibility: The Video Capture Card can work with video devices with RCA connector or S-Video connector, such as VHS, VCR, Hi8, camcorder, compatible with Windows and Mac OS. Support video formats like NTSC, PAL, and support brightness, contrast, hue, and saturation control
- Note: The Video Converter is used with acquisition software. We recommend OBS Studio or PotPlayer for Windows, and QuickTime Player for Mac. They can be downloaded for free online. Please operate according to the steps in User Manual or contact us if you have any questions
gst-launch-1.0 -e
uridecodebin uri="file:///path/to/input.mkv" name=d
flvmux name=mux streamable=true !
rtmpsink location="rtmps://a.rtmp.youtube.com/live2/REDACTED_KEY live=1"
d. ! queue ! videoconvert ! x264enc ! mux.
d. ! queue max-size-time=5000000000 max-size-bytes=0 max-size-buffers=0 !
audioconvert ! audioresample ! voaacenc ! mux.This is an illustrative launch shape, not a tested command for every operating system, GStreamer build, or media file. Replace the input URI and endpoint with your own values. Keep the stream key private; do not paste a real key into logs, public examples, or support posts.
What each part does
uridecodebinselects available source, demux, and decoder elements and exposes decoded streams. It cannot decode a format if the machine lacks a suitable plugin.videoconvert,audioconvert, andaudioresampleadapt decoded raw media for downstream encoders.x264encencodes video as H.264;voaacencencodes audio as AAC. The actual installed encoder and negotiated formats depend on your GStreamer installation.flvmuxcombines the streams for the RTMP workflow. Its documented H.264 input is in AVC stream format;rtmpsinksends FLV content to an RTMP server.- The separate
queueelements let the audio and video branches run independently. The larger audio queue limit in the example follows GStreamer’s tutorial guidance for encoder buffering; it is not a universal latency target.
For a file without audio or without video, remove the branch for the absent stream. For multi-track files, do not assume a command-line autoplugging example selects the intended language, track, or stream. An application should inspect dynamic pads and apply explicit stream-selection policy.
Rank #2
- [Capture & HDMI Loop Out – Record While Watching] This USB video capture card lets you digitize VHS tapes, VCR, DVD players, camcorders, and retro game consoles while simultaneously viewing the video on a larger HDMI TV or monitor. The HDMI loop-out feature allows real-time playback on a big screen while capturing to your computer—perfect for enjoying and preserving old memories.
- [Convert VHS & Analog Video to Digital] Easily convert old VHS tapes and analog AV signals into digital video files on your computer. Capture nostalgic home videos, family events, or retro gaming footage and store them permanently in digital format for easy backup, editing, or sharing.
- [Digitize Your Vintage Home Videos] Preserve your old VHS memories in high-quality digital format. We help restore faded VHS tapes and convert them into clear 1080p digital files for long-term safekeeping and easy sharing. Works with most popular open-source capture software, supporting batch processing, clip editing, and one-click upload to YouTube and Facebook. Perfect for preserving wedding videos, birthday footage, and other precious home movies from the past.
- [Convert Analog to HDMI in Real Time with USB Capture] USB video capture card with HDMI live preview and multi-device compatibility. Stream analog content directly to modern HDMI displays in real time! Convert RCA/AV signals to HDMI with a switchable 720p/1080p output for TVs, projectors, and gaming monitors. Plus, use the HDMI loop-through feature to monitor the digitization process as you capture—no more uncertainty!
- [Retro Tech Revival – Connect Classic Devices to Modern Screens] Retro Tech Revival: Bring Back VCRs, Wii and More Classic DevicesSupports VHS/VCR/DVD players, Hi8 camcorders, PS2, Wii and other RCA-connected devices. Comes with RCA/AV cables and a USB-C adapter. Renew your old equipment easily—stream retro games, digitize video tapes, or connect legacy devices to 4K TVs without hassle!
Verify plugins and negotiated formats
Before diagnosing YouTube, check that the running machine has the elements your pipeline names. GStreamer plugin packaging varies by distribution and installation. The official handy-elements tutorial explains decodebin, conversion, and resampling; the GStreamer tools tutorial covers the transcoding pattern.
- Run
gst-inspect-1.0 uridecodebin,gst-inspect-1.0 x264enc,gst-inspect-1.0 voaacenc,gst-inspect-1.0 flvmux, andgst-inspect-1.0 rtmpsink. If you use another AAC encoder or sink, inspect that element instead. - Use a GStreamer discovery tool or a playback pipeline to establish which audio and video streams the source contains, and whether installed decoders can read them.
- Run the launch pipeline with
-vto print negotiated caps. Compare the actual formats at encoder, muxer, and sink boundaries with the elements’ reported pad capabilities. - Read the complete GStreamer bus error and YouTube or encoder report. If the pattern still fails, capture the full error and caps rather than inferring the cause from the title of the error alone.
Caps filters can constrain a format, but use one only when you know the downstream element requires that format. A filter cannot install a missing decoder, make incompatible media compatible, or change an RTMP sender into an HLS sender.
Recommended Free Tools
Rank #3
- 【1080P 60FPS Video Capture Card】 This HDMI game capture card is based on USB3.0 high speed transmission port, input resolution up to 4K@30HZ, output resolution up to 2K@30Hz or 1920×1080@60Hz. Type c and USB interface can meet most of the devices in daily life. Easily meet the online capture, real-time recording, online meetings, live gaming and other functions, so you have a better visual enjoyment. Note: For capture use only; requires capture software to function and is not intended for direct screen casting to a monitor or TV
- 【Ultra Low Latency Screen Sharing】 HDMI capture card is made of good quality aluminum alloy with strong heat dissipation, allowing you to enjoy ultra low latency while live gaming or video recording or live streaming, avoiding blue screens and lag. This HDMI to USBC capture card supports easy recording of good quality audio or HD video and transferring it to your computer or streaming platform, allowing you to record 60 fps HD video directly on your hard drive and real-time preview
- 【Plug and Play, Easy to Carry】 This HDMI 1080P video capture card does not require any additional drivers or external power supply, just plug and play for fast capture. The capture card is small and lightweight, so you can put it in your bag for emergencies, making it very portable for outdoor live streaming. It's also a great way to share content in game recording, video conference, video recorder and online teaching
- 【Wide Compatibility USB Capture Card】 Easily streams to Facebook, Youtube or Twitch. With the connection, this HDMI to USB C/3.0 video capture devices can be working on several Operating Systems and various software: Windows 7/ 8/ 10, Mac OS or above, Linux, Android, Laptop, Xbox One, PS3/PS4/PS5, Camera, DVDs, Set Top Box, Webcame, DSLR, Switch/Switch 2, TV BOX, HDTV, Potplayer/VLC, ZOOM, OBS Studio etc.
- 【Package Content & Note】 1x HD Audio Capture Card , 1x USB 3.0 to USB C Adapter (A-side 3.0, B-side 2.0), 1x user manual. Please note that you need to restart the OBS Studio software after the audio setup is complete, otherwise it will result in no sound output. When using an adapter, if the device is recognized as USB 2.0, try using the other side with the USB-C port. Simply flip the capture card and reconnect it to be recognized as USB 3.0
Choose conversion, pass-through, or another ingest protocol
Transcode when the input cannot feed the selected output
Decoding and re-encoding is appropriate when the source codec, container, or available muxer cannot produce a stream compatible with the chosen ingest path. It uses compute and can reduce quality, so avoid transcoding compatible encoded streams when your actual pipeline and muxer can safely pass them through.
Use RTMPS for the RTMP workflow
For an RTMP/RTMPS setup, match the output codec and muxing to YouTube’s current guidance, and prefer RTMPS as YouTube recommends. Do not add bitrate, profile, resolution, GOP, or keyframe values by guesswork: the right values depend on the stream requirements and current YouTube guidance.
Rank #4
- This Video Capture Card Can transfer video and audio from VHS, VCR, DVD, Hi8, DV tapes, camcorders, or other video source devices with RCA or S-Video interfaces to your PC or Mac synchronously.
- Convert analog RCA/S-Video audio and video signal input to high-definition 1080P/30fps USB-A/USB-C output, digitize and save your good memories with your friends and family on your computer, share with your friends and family, leaving precious memories
- Plug and play, easy to operate, just connect the RCA or S-Video interface of your video recorder to the USB-A/USB-C interface of your computer or notebook and it can be used without any driver. Note: It needs to be used with the acquisition software
- Compatible with USB-A/USB-C interfaces, not limited by computer interfaces, compatible with Windows and Mac OS, supports NTSC, PAL and other video formats, and supports brightness, contrast, hue and saturation control
- Note: This video converter needs to be used with capture software, which can be downloaded free of chargge . We recommend OBS Studio or PotPlayer for Windows and QuickTime Player for Mac. Please feel free to contact us if you need technical support.
Consider HLS when RTMP is the constraint
If your intended codec is outside the RTMP workflow, or the job is an HDR workflow for which YouTube documents HLS, evaluate HLS ingestion and a sender that supports it. HLS requires the protocol-specific setup; it is not a codec-only change to the RTMP/FLV command above.
Troubleshoot common failure patterns
| Symptom | What to check | Next step |
|---|---|---|
| YouTube reports an unsupported codec | Selected ingest protocol and the codecs actually negotiated at the output | Match output to the current RTMP/RTMPS or HLS guidance; do not assume the error identifies which component rejected it. |
uridecodebin fails or exposes no expected stream |
Input URI, source tracks, and installed demuxer/decoder plugins | Verify the file’s streams and install or select a decoder available in your GStreamer build. |
The pipeline reports a link or caps-negotiation error near flvmux |
Verbose negotiated caps and the muxer’s accepted pad formats | Confirm the video is H.264 in the required AVC stream format and that audio can link to the muxer; adjust conversion or encoding accordingly. |
| Startup stalls or reports queue/preroll errors | Branch queues and encoder buffering, especially when audio and video are separate branches | Review queue limits and the GStreamer tutorial’s guidance. tune=zerolatency may help live operation, but has a quality trade-off; do not apply it without considering output quality. |
| The RTMP pipeline cannot carry the intended workflow | Whether the requirement is an RTMP codec limitation or an HDR/HLS workflow | Assess YouTube HLS ingest and use an HLS-capable sender rather than expecting FLV over RTMP to carry that workflow. |
Or let it run in the cloud
If your goal is a continuous YouTube loop rather than building and maintaining a local GStreamer pipeline, StreamNeo runs uploaded videos from the cloud. Upload your recording or build a playlist, add your YouTube stream key, and go live. Your computer and home connection do not need to stay on; uploads stream as made, up to 4K 60fps, at one price per slot; StreamNeo automatically recovers if YouTube drops the stream. The first day is free with no card. Monthly pricing is $9.99 per month. StreamNeo is for YouTube and uploaded videos, not camera-based live capture. Start your free first day.
The Tool Desk
Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
