Skip to content
cccskills
FreePublished on GitHub

control-spectator

Control CARLA’s on-screen camera to view a vehicle from behind, above, the driver’s seat, or the front. Select vehicles by name, role, or ID, frame them once, or follow them as they move.

OriginalShow the original description

Moves the CARLA spectator camera, frames an actor, or follows one live — third-person/chase, first-person/driver, top-down, or front views, resolving natural-language targets like "the ego" or "the Toyota Prius" to a specific actor. Use when the user asks to "move the camera/spectator", "watch/follow vehicle X", "3rd-person view of the ego", "1st-person view of the prius", "bird's-eye view", or "look at (x,y,z)".

See how to install

Good for

  • Following the ego vehicle from behind
  • Viewing a Toyota Prius from the driver’s seat
  • Watching a vehicle from above
  • Positioning the camera over an intersection

Files included (5)

  • SKILL.md5.0 KB
  • references/spectator.md2.8 KB
  • scripts/check_env.sh2.1 KB
  • scripts/env.sh1.1 KB
  • scripts/spectator.py10.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Control the CARLA spectator

Paths. scripts/… and references/… below are relative to the directory holding this SKILL.md. Your working directory is the user's project, not that directory, so prefix them with its absolute path or the command is not found.

Aim the on-screen camera (the "spectator"). Move it to a pose, frame an actor in a preset view, or follow a moving actor. The spectator cannot be attached to an actor (the API has no reparent for it) — following is emulated by re-setting its transform every world tick.

Resolving the target from words

Like the other skills, this emits structured data (actors) and the agent filters it:

  • "the ego" → --role hero (CARLA's ego role_name is usually hero).
  • "the Toyota Prius" → --filter '*prius*' (or vehicle.toyota.prius).
  • a specific one → --id N.

"3rd-person view of the ego" → follow --view chase --role hero. "1st-person of the prius" → follow --view first --filter '*prius*'. On multiple matches it picks the nearest and says so — run actors first if you need to choose.

Instructions

Progress:
- [ ] Step 1: Check prerequisites (bash scripts/check_env.sh), clear FAILs
- [ ] Step 2: Resolve the target (actors) if the request names an actor
- [ ] Step 3: move / look (one-shot) / follow (live) in the requested view

Commands need CARLA_HOST/CARLA_PORT from scripts/env.sh. Only useful on a rendered server (windowed or packaged) — the spectator is that window's camera. Negative coordinates: pass move --at with an = (--at=-24,-57,20) so the leading minus isn't parsed as a flag.

Step 1: Check prerequisites

bash scripts/check_env.sh

Step 2-3: Aim it

source scripts/env.sh

# list actors to resolve a name
python3 scripts/spectator.py actors
python3 scripts/spectator.py actors --filter '*prius*'

# move to an explicit pose (looking slightly down)
python3 scripts/spectator.py move --at 40,20,15 --pitch -30 --yaw 90

# one-shot framing (no loop): chase view of the ego
python3 scripts/spectator.py look --view chase --role hero

# live follow for 30s: 1st-person of the prius
python3 scripts/spectator.py follow --view first --filter '*prius*' --seconds 30

# bird's-eye follow of actor 87
python3 scripts/spectator.py follow --view top --id 87 --seconds 20

Views: chase (3rd-person behind+above), first (driver), top (bird's eye), front (ahead, looking back). Tune with --distance/--height/--pitch.

Examples

Example 1: 3rd-person of the ego

User says: "give me a 3rd-person view of the ego"

follow --view chase --role hero --seconds 30. The camera chases the hero from behind and above.

Example 2: 1st-person of a named car

User says: "1st-person view of the Toyota Prius"

follow --view first --filter '*prius*'. If several Priuses exist it uses the nearest and reports the id; run actors --filter '*prius*' to pick a specific one.

Example 3: park the camera and look at a spot

User says: "look at the crossroads at (42,24)"

move --at 42,54,20 --pitch -35 --yaw -90 (offset back from the point and angle down), or look at a nearby actor.

Troubleshooting

Problem: nothing changes on screen Cause: headless -nullrhi server (no window), or you're viewing a different client's camera. Solution: use a windowed/packaged server; the spectator is that view.

Problem: follow doesn't track in sync mode Cause: it updates on world ticks; in sync mode nothing ticks unless a client does. Solution: run the tick loop (set-world-settings), or follow in async mode.

Problem: "can I attach the spectator to the car?" Answer: not directly — the API can't reparent the spectator. follow gives the same effect by updating its transform each tick. For a recorded/attached camera, spawn a camera sensor with SpringArm attachment (create-sensor skill).

Problem: wrong actor chosen Cause: several actors matched the selector. Solution: run actors and pass --id, or narrow --filter.

Outputs

Server-side camera state (the on-screen view). follow runs for --seconds then stops cleanly. No file produced.

Detail (view math, attachment vs following, selector semantics, sync-mode) in references/spectator.md.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Add a message type to CARLA's native ROS 2 interface. Create its C++ data structure, serialization code for transmission, type identity hash, registration, and tests, with Docker-based hash calculation and build checks.

  • Adding a standard ROS 2 message type missing from CARLA
  • Defining a custom carla_msgs message
  • Investigating type-hash warnings
carla-simulator/carla14.5KUpdated Oct 18, 2026

Extend CARLA’s native ROS 2 interface to publish sensor data or receive vehicle commands. Covers topic implementation, registration, data connections, and verification, plus adding middleware, the communication layer used to exchange messages.

  • Publish obstacle sensor data to ROS 2
  • Add a topic for vehicle speed commands
  • Integrate another communication middleware
carla-simulator/carla14.5KUpdated Oct 18, 2026

Summarize ScenarioRunner results to see which scenarios passed and which checks failed. Compare runs before and after changes, or analyze recorded driving to produce measurements and plots of vehicle distance and deviation from the lane center.

  • Checking scenario pass and fail results
  • Comparing results before and after controller changes
  • Plotting vehicle distances from a recorded run
carla-simulator/carla14.5KUpdated Oct 18, 2026

audit-carla-docs

FreeSummary

Checks a local CARLA checkout for missing API documentation, outdated references, broken links, and pages absent from navigation. Produces a grouped Markdown report without building the project or running the simulator.

  • Reviewing documentation before a release
  • Finding missing or outdated API references
  • Checking broken links and navigation gaps
carla-simulator/carla14.5KUpdated Oct 18, 2026

bounding-boxes

FreeSummary

Read and display CARLA object bounding boxes, then project them onto a camera image as 2D rectangles. Export an annotated PNG and box coordinates in JSON for object detection annotation work.

  • Adding vehicle boxes to a camera image
  • Exporting box coordinates for detection annotations
  • Checking vehicle dimensions
carla-simulator/carla14.5KUpdated Oct 18, 2026

build-carla-ue4

FreeSummary

Builds CARLA's ue4-dev branch on Linux, producing the Unreal Engine 4.26 editor, server modules, and an installed Python client package. Fetches required content, optionally compiles native ROS 2 support, and verifies the build against a source-built server.

  • Building CARLA ue4-dev from source
  • Compiling CARLA with native ROS 2 support
  • Building the Python client for an existing environment
carla-simulator/carla14.5KUpdated Oct 18, 2026

See all skills by carla-simulator

Report a problem with this skill