[Config Support]: How to handle special characters (e.g "@") in RTSP passwords?

[victorhooi]

Describe the problem you are having

I'm on the "develop" branch for Frigate.

Recently (~ 2-3 weeks), an upgrade (or something else that happened to occur at a similar time) has broken the RTSP authentication in Frigate, and they don't seem to be able to connect to the cameras anymore.

My cameras are Axis P3248-LV cameras. The password does contain special characters (*, and @, for example). The cameras are able to be connected with other NVR software (e.g. NX Witness), and ffprobe seems to be able to read them as well:

ffprobe "rtsp://root:password_with_*and@[email protected]:554/axis-media/media.amp?streamprofile=hdwitnessSecondary&event=on"
ffprobe version 7.1 Copyright (c) 2007-2024 the FFmpeg developers
  built with Apple clang version 16.0.0 (clang-1600.0.26.3)
  configuration: --prefix=/opt/homebrew/Cellar/ffmpeg/7.1 --enable-shared --enable-pthreads --enable-version3 --cc=clang --host-cflags= --host-ldflags='-Wl,-ld_classic' --enable-ffplay --enable-gnutls --enable-gpl --enable-libaom --enable-libaribb24 --enable-libbluray --enable-libdav1d --enable-libharfbuzz --enable-libjxl --enable-libmp3lame --enable-libopus --enable-librav1e --enable-librist --enable-librubberband --enable-libsnappy --enable-libsrt --enable-libssh --enable-libsvtav1 --enable-libtesseract --enable-libtheora --enable-libvidstab --enable-libvmaf --enable-libvorbis --enable-libvpx --enable-libwebp --enable-libx264 --enable-libx265 --enable-libxml2 --enable-libxvid --enable-lzma --enable-libfontconfig --enable-libfreetype --enable-frei0r --enable-libass --enable-libopencore-amrnb --enable-libopencore-amrwb --enable-libopenjpeg --enable-libspeex --enable-libsoxr --enable-libzmq --enable-libzimg --disable-libjack --disable-indev=jack --enable-videotoolbox --enable-audiotoolbox --enable-neon
  libavutil      59. 39.100 / 59. 39.100
  libavcodec     61. 19.100 / 61. 19.100
  libavformat    61.  7.100 / 61.  7.100
  libavdevice    61.  3.100 / 61.  3.100
  libavfilter    10.  4.100 / 10.  4.100
  libswscale      8.  3.100 /  8.  3.100
  libswresample   5.  3.100 /  5.  3.100
  libpostproc    58.  3.100 / 58.  3.100
Input #0, rtsp, from 'rtsp://root:BwmvwgCD-t4U@J6js*[email protected]:554/axis-media/media.amp?streamprofile=hdwitnessSecondary&event=on':
  Metadata:
    title           : Session streamed with GStreamer
    comment         : rtsp-server
  Duration: N/A, start: 0.097958, bitrate: N/A
  Stream #0:0: Video: h264 (High), yuvj420p(pc, bt709, progressive), 640x360, 7 fps, 25 tbr, 90k tbn
  Stream #0:1: Audio: aac (LC), 48000 Hz, mono, fltp
  Stream #0:2: Data: none
Unsupported codec with id 0 for input stream 2

Previously, my Frigate config.yaml just had the password as is - and it magically worked.

However, after the breakage - I did try escaping the @ character with a backslash - that didn't seem to work. I've also now tried escaping the entire password string with single quotes (which is the config pasted below) - that doesn't seem to work either.

Does anybody know what might be happening here, or if the behaviour might have changed somehow? Or what is the "correct" way in Frigate to pass a RTSP password with special characters?

Version

0.15.0-2137de3

Frigate config file

mqtt:
  enabled: false

cameras:
  dummy_camera: # <--- this will be changed to your actual camera later
    enabled: false
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:554/rtsp
          roles:
            - detect

  bedroom:
    enabled: true
    ffmpeg:
      inputs:
        - path:
            rtsp://root:'passwithwith@characters'@10.5.1.190:554/axis-media/media.amp?streamprofile=hdwitnessSecondary
          roles:
            - detect
        - path:
            rtsp://root:'passwithwith@characters'@10.5.1.190:554/axis-media/media.amp?streamprofile=hdwitnessPrimary
          roles:
            - record
    # detect:
    #   width: 640 # <- optional, by default Frigate tries to automatically detect resolution
    #   height: 360 # <- optional, by default Frigate tries to automatically detect resolution

    zones: {}
    review: {}

  kids_bedroom:
    enabled: true
    ffmpeg:
      inputs:
        - path:
            rtsp://root:'passwithwith@characters'@10.5.1.193:554/axis-media/media.amp?streamprofile=hdwitnessSecondary
          roles:
            - detect
        - path:
            rtsp://root:'passwithwith@characters'@10.5.1.193:554/axis-media/media.amp?streamprofile=hdwitnessPrimary
          roles:
            - record
    # detect:
    #   width: 640 # <- optional, by default Frigate tries to automatically detect resolution
    #   height: 360 # <- optional, by default Frigate tries to automatically detect resolution

    zones: {}
    review: {}

  living_room:
    enabled: true
    ffmpeg:
      inputs:
        - path:
            rtsp://root:'passwithwith@characters'@10.5.1.199:554/axis-media/media.amp?streamprofile=hdwitnessSecondary
          roles:
            - detect
        - path:
            rtsp://root:'passwithwith@characters'@10.5.1.199:554/axis-media/media.amp?streamprofile=hdwitnessPrimary
          roles:
            - record
    # detect:
    #   width: 640 # <- optional, by default Frigate tries to automatically detect resolution
    #   height: 360 # <- optional, by default Frigate tries to automatically detect resolution

    zones: {}
    review: {}

  stairway:
    enabled: true
    ffmpeg:
      inputs:
        - path:
            rtsp://root:'passwithwith@characters'@10.5.1.157:554/axis-media/media.amp?streamprofile=hdwitnessSecondary
          roles:
            - detect
        - path:
            rtsp://root:'passwithwith@characters'@10.5.1.157:554/axis-media/media.amp?streamprofile=hdwitnessPrimary
          roles:
            - record
    # detect:
    #   width: 640 # <- optional, by default Frigate tries to automatically detect resolution
    #   height: 360 # <- optional, by default Frigate tries to automatically detect resolution

    zones: {}
    review: {}

version: 0.15-0

model:
  path: plus://d31dec2d1734b0f0dfdd21f67599e721

objects:
  filters:
    dog:
      min_score: .7
      threshold: .9
    cat:
      min_score: .65
      threshold: .8
    face:
      min_score: .7
    package:
      min_score: .65
      threshold: .9
    license_plate:
      min_score: .6
    amazon:
      min_score: .75
    ups:
      min_score: .75
    fedex:
      min_score: .75
    person:
      min_score: .65
      threshold: .85
    car:
      min_score: .65
      threshold: .85
  track:
    - person
    - car
    - dog
    - cat

detectors:
  coral:
    type: edgetpu
    device: usb

record:
  enabled: true
  retain:
    days: 7
    mode: motion
  alerts:
    retain:
      days: 30
  detections:
    retain:
      days: 30
snapshots:
  enabled: true
  retain:
    default: 30

ffmpeg:
  output_args:
    record: preset-record-generic-audio-aac

Relevant Frigate log output

2024-10-20 12:39:48.148677312  [2024-10-20 12:39:48] watchdog.living_room           ERROR   : Ffmpeg process crashed unexpectedly for living_room.
2024-10-20 12:39:48.148805273  [2024-10-20 12:39:48] watchdog.living_room           ERROR   : The following ffmpeg logs include the last 100 lines prior to exit.
2024-10-20 12:39:48.148930235  [2024-10-20 12:39:48] ffmpeg.living_room.detect      ERROR   : [rtsp @ 0xaaaaf75459d0] method DESCRIBE failed: 401 Unauthorized
2024-10-20 12:39:48.149045076  [2024-10-20 12:39:48] ffmpeg.living_room.detect      ERROR   : [in#0 @ 0xaaaaf75457c0] Error opening input: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.149150037  [2024-10-20 12:39:48] ffmpeg.living_room.detect      ERROR   : Error opening input file rtsp://*:*@10.5.1.199:554/axis-media/media.amp?streamprofile=hdwitnessSecondary.
2024-10-20 12:39:48.149263239  [2024-10-20 12:39:48] ffmpeg.living_room.detect      ERROR   : Error opening input files: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.153042561  [2024-10-20 12:39:48] watchdog.kids_bedroom          ERROR   : Ffmpeg process crashed unexpectedly for kids_bedroom.
2024-10-20 12:39:48.153176843  [2024-10-20 12:39:48] watchdog.kids_bedroom          ERROR   : The following ffmpeg logs include the last 100 lines prior to exit.
2024-10-20 12:39:48.153239763  [2024-10-20 12:39:48] ffmpeg.kids_bedroom.detect     ERROR   : [rtsp @ 0xaaaaebe429d0] method DESCRIBE failed: 401 Unauthorized
2024-10-20 12:39:48.153304604  [2024-10-20 12:39:48] ffmpeg.kids_bedroom.detect     ERROR   : [in#0 @ 0xaaaaebe427c0] Error opening input: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.153368205  [2024-10-20 12:39:48] ffmpeg.kids_bedroom.detect     ERROR   : Error opening input file rtsp://*:*@10.5.1.193:554/axis-media/media.amp?streamprofile=hdwitnessSecondary.
2024-10-20 12:39:48.153429046  [2024-10-20 12:39:48] ffmpeg.kids_bedroom.detect     ERROR   : Error opening input files: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.155131025  [2024-10-20 12:39:48] watchdog.bedroom               ERROR   : Ffmpeg process crashed unexpectedly for bedroom.
2024-10-20 12:39:48.155271986  [2024-10-20 12:39:48] watchdog.bedroom               ERROR   : The following ffmpeg logs include the last 100 lines prior to exit.
2024-10-20 12:39:48.181914206  [2024-10-20 12:39:48] ffmpeg.bedroom.detect          ERROR   : [rtsp @ 0xaaaaf4e9b9d0] method DESCRIBE failed: 401 Unauthorized
2024-10-20 12:39:48.182507733  [2024-10-20 12:39:48] ffmpeg.bedroom.detect          ERROR   : [in#0 @ 0xaaaaf4e9b7c0] Error opening input: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.182583894  [2024-10-20 12:39:48] ffmpeg.bedroom.detect          ERROR   : Error opening input file rtsp://*:*@10.5.1.190:554/axis-media/media.amp?streamprofile=hdwitnessSecondary.
2024-10-20 12:39:48.182604734  [2024-10-20 12:39:48] ffmpeg.bedroom.detect          ERROR   : Error opening input files: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.187465429  [2024-10-20 12:39:48] watchdog.stairway              ERROR   : Ffmpeg process crashed unexpectedly for stairway.
2024-10-20 12:39:48.187531470  [2024-10-20 12:39:48] watchdog.stairway              ERROR   : The following ffmpeg logs include the last 100 lines prior to exit.
2024-10-20 12:39:48.187556430  [2024-10-20 12:39:48] ffmpeg.stairway.detect         ERROR   : [rtsp @ 0xaaaaf7dd09d0] method DESCRIBE failed: 401 Unauthorized
2024-10-20 12:39:48.187659351  [2024-10-20 12:39:48] ffmpeg.stairway.detect         ERROR   : [in#0 @ 0xaaaaf7dd07c0] Error opening input: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.187678991  [2024-10-20 12:39:48] ffmpeg.stairway.detect         ERROR   : Error opening input file rtsp://*:*@10.5.1.157:554/axis-media/media.amp?streamprofile=hdwitnessSecondary.
2024-10-20 12:39:48.187781472  [2024-10-20 12:39:48] ffmpeg.stairway.detect         ERROR   : Error opening input files: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.192801849  [2024-10-20 12:39:48] ffmpeg.living_room.record      ERROR   : [rtsp @ 0xaaaabd9a8ad0] method DESCRIBE failed: 401 Unauthorized
2024-10-20 12:39:48.192863850  [2024-10-20 12:39:48] ffmpeg.living_room.record      ERROR   : [in#0 @ 0xaaaabd9a88e0] Error opening input: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.192915730  [2024-10-20 12:39:48] ffmpeg.living_room.record      ERROR   : Error opening input file rtsp://*:*@10.5.1.199:554/axis-media/media.amp?streamprofile=hdwitnessPrimary.
2024-10-20 12:39:48.193147493  [2024-10-20 12:39:48] ffmpeg.living_room.record      ERROR   : Error opening input files: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.193262694  [2024-10-20 12:39:48] watchdog.living_room           INFO    : Terminating the existing ffmpeg process...
2024-10-20 12:39:48.193266654  [2024-10-20 12:39:48] watchdog.living_room           INFO    : Waiting for ffmpeg to exit gracefully...
2024-10-20 12:39:48.194696430  [2024-10-20 12:39:48] ffmpeg.kids_bedroom.record     ERROR   : [rtsp @ 0xaaaaeb101ad0] method DESCRIBE failed: 401 Unauthorized
2024-10-20 12:39:48.194796911  [2024-10-20 12:39:48] ffmpeg.kids_bedroom.record     ERROR   : [in#0 @ 0xaaaaeb1018e0] Error opening input: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.194817912  [2024-10-20 12:39:48] ffmpeg.kids_bedroom.record     ERROR   : Error opening input file rtsp://*:*@10.5.1.193:554/axis-media/media.amp?streamprofile=hdwitnessPrimary.
2024-10-20 12:39:48.194918393  [2024-10-20 12:39:48] ffmpeg.kids_bedroom.record     ERROR   : Error opening input files: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.194938153  [2024-10-20 12:39:48] watchdog.kids_bedroom          INFO    : Terminating the existing ffmpeg process...
2024-10-20 12:39:48.195037474  [2024-10-20 12:39:48] watchdog.kids_bedroom          INFO    : Waiting for ffmpeg to exit gracefully...
2024-10-20 12:39:48.223211231  [2024-10-20 12:39:48] ffmpeg.bedroom.record          ERROR   : [rtsp @ 0xaaaae92c1ad0] method DESCRIBE failed: 401 Unauthorized
2024-10-20 12:39:48.223363633  [2024-10-20 12:39:48] ffmpeg.bedroom.record          ERROR   : [in#0 @ 0xaaaae92c18e0] Error opening input: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.247707267  [2024-10-20 12:39:48] frigate.video                  ERROR   : living_room: Unable to read frames from ffmpeg process.
2024-10-20 12:39:48.247823949  [2024-10-20 12:39:48] frigate.video                  ERROR   : kids_bedroom: Unable to read frames from ffmpeg process.
2024-10-20 12:39:48.247890349  [2024-10-20 12:39:48] frigate.video                  ERROR   : living_room: ffmpeg process is not running. exiting capture thread...
2024-10-20 12:39:48.247988711  [2024-10-20 12:39:48] frigate.video                  ERROR   : kids_bedroom: ffmpeg process is not running. exiting capture thread...
2024-10-20 12:39:48.248451276  [2024-10-20 12:39:48] ffmpeg.bedroom.record          ERROR   : Error opening input file rtsp://*:*@10.5.1.190:554/axis-media/media.amp?streamprofile=hdwitnessPrimary.
2024-10-20 12:39:48.249031402  [2024-10-20 12:39:48] ffmpeg.bedroom.record          ERROR   : Error opening input files: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.249084243  [2024-10-20 12:39:48] watchdog.bedroom               INFO    : Terminating the existing ffmpeg process...
2024-10-20 12:39:48.249171284  [2024-10-20 12:39:48] watchdog.bedroom               INFO    : Waiting for ffmpeg to exit gracefully...
2024-10-20 12:39:48.249937853  [2024-10-20 12:39:48] ffmpeg.stairway.record         ERROR   : [rtsp @ 0xaaaaddd4fad0] method DESCRIBE failed: 401 Unauthorized
2024-10-20 12:39:48.249991733  [2024-10-20 12:39:48] ffmpeg.stairway.record         ERROR   : [in#0 @ 0xaaaaddd4f8e0] Error opening input: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.250095854  [2024-10-20 12:39:48] ffmpeg.stairway.record         ERROR   : Error opening input file rtsp://*:*@10.5.1.157:554/axis-media/media.amp?streamprofile=hdwitnessPrimary.
2024-10-20 12:39:48.250100174  [2024-10-20 12:39:48] ffmpeg.stairway.record         ERROR   : Error opening input files: Server returned 401 Unauthorized (authorization failed)
2024-10-20 12:39:48.250167535  [2024-10-20 12:39:48] watchdog.stairway              INFO    : Terminating the existing ffmpeg process...
2024-10-20 12:39:48.250217976  [2024-10-20 12:39:48] watchdog.stairway              INFO    : Waiting for ffmpeg to exit gracefully...
2024-10-20 12:39:48.263350244  [2024-10-20 12:39:48] frigate.video                  ERROR   : bedroom: Unable to read frames from ffmpeg process.
2024-10-20 12:39:48.263801329  [2024-10-20 12:39:48] frigate.video                  ERROR   : bedroom: ffmpeg process is not running. exiting capture thread...
2024-10-20 12:39:48.288031082  [2024-10-20 12:39:48] frigate.video                  ERROR   : stairway: Unable to read frames from ffmpeg process.
2024-10-20 12:39:48.288209844  [2024-10-20 12:39:48] frigate.video                  ERROR   : stairway: ffmpeg process is not running. exiting capture thread...

Relevant go2rtc log output

NA

Frigate stats

No response

Operating system

Debian

Install method

Docker Compose

docker-compose file or Docker CLI command

version: "3.9"
services:
  frigate:
    container_name: frigate
    privileged: true # this may not be necessary for all setups
    restart: unless-stopped
    #    image: ghcr.io/blakeblackshear/frigate:stable
    #image: ghcr.io/blakeblackshear/frigate:b4acf4f-standard-arm64
    #image: ghcr.io/blakeblackshear/frigate:9c75123-standard-arm64 # crashes with some go2rtc index out of rnage issue
#    image: ghcr.io/blakeblackshear/frigate:039ab1c-standard-arm64
    #image: ghcr.io/blakeblackshear/frigate:47ad0ca-standard-arm64
#    image: ghcr.io/blakeblackshear/frigate:0b71cfa-standard-arm64
#    image: ghcr.io/blakeblackshear/frigate:ee8091b-standard-arm64
    #image: ghcr.io/blakeblackshear/frigate:0fc7999-standard-arm64
    #image: ghcr.io/blakeblackshear/frigate:eda52a3-standard-arm64
    #image: ghcr.io/blakeblackshear/frigate:5f77408-standard-arm64
    #image: ghcr.io/blakeblackshear/frigate:6294ce7-standard-arm64
    image: ghcr.io/blakeblackshear/frigate:2137de3-standard-arm64

    shm_size: "64mb" # update for your cameras based on calculation above
    devices:
      - /dev/bus/usb:/dev/bus/usb  # Passes the USB Coral, needs to be modified for other versions
      #- /dev/apex_0:/dev/apex_0    # Passes a PCIe Coral, follow driver instructions here https://coral.ai/docs/m2/get-started/#2a-on-linux
      #- /dev/video11:/dev/video11  # For Raspberry Pi 4B
      #- /dev/dri/renderD128:/dev/dri/renderD128 # For intel hwaccel, needs to be updated for your hardware
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /home/victorhooi/frigate-docker/config:/config
      - /home/victorhooi/frigate-docker/storage:/media/frigate
      - type: tmpfs # Optional: 1GB of memory, reduces SSD/SD Card wear
        target: /tmp/cache
        tmpfs:
          size: 1000000000
    ports:
      - "5000:5000"
      - "8554:8554" # RTSP feeds
      - "8555:8555/tcp" # WebRTC over tcp
      - "8555:8555/udp" # WebRTC over udp
    environment:
      FRIGATE_RTSP_PASSWORD: "password"
      PLUS_API_KEY: ${PLUS_API_KEY}

Object Detector

Coral

Screenshots of the Frigate UI's System metrics pages

No response

Any other information that may be helpful

No response

[NickM-27]

in general the best way to handle this would be use to url encoded special characters, I don't believe anything has changed here with Frigate and many of my cameras with @ in the password continue to work without issues