asciinema releases

Highlights

• new Explore page (/explore), showing live and upcoming streams plus popular and recent recordings, with sub-pages for browsing full lists
• new user profile page, showing live and upcoming streams and recent recordings, with sub-pages for browsing full lists
• improved view counting - now a view is counted after the playback starts instead of on page load
• new recording popularity algorithm based on weighted daily view counts from last 90 days
• improved performance of all pages showing a recordings list
• fixed user links in admin panel
• added visibility badges to a user's own streams
• changed profile path for temporary users (owners of unclaimed uploads) from /u/<id> to ~user:<id>
• fixed race condition in the local file store impl when multiple processes attempted to write to the same path
• various UI tweaks
• housekeeping: moved full-text-search columns to separate db table; db index cleanup; etc.
• lots of new unit and feature tests

Upgrading

No manual changes needed other than bumping the container image version number as shown here.

This release is quite packed, including several new features and tons of improvements.

Highlights

• replaced Bootstrap 4 with a simpler, custom CSS setup
• replaced Source Sans Pro and Fira Code with Fira Sans and JetBrains Mono as UI fonts
• replaced TTF with WOFF2 for all fonts
• added Share button to the stream page
• implemented email address verification when changing account's email
• added time zone setting to user accounts
• added schedule setting to streams (see below)
• upgraded asciinema player
• implemented Nerd Font symbols support in SVG previews
• fixed special chars (e.g. shaded blocks) rendering in uncropped SVG previews
• added "Render bold text with bright colors" option to accounts, recordings and streams (see below)
• added copy-to-clipboard button for URLs and command snippets
• shortened length of the secret token for new recordings to 16 characters (matches streams now)
• improved readability of the /about page
• added login links for user pages in the admin panel (see below)
• various other tweaks, refactorings and cleanups

Stream scheduling

Streams can now be scheduled, by setting a cron expression in stream settings. A scheduled stream is a good way to inform the audience about stream's next start time. Scheduled streams are displayed on user profile in the "Upcoming streams" section, presenting a countdown timer both on the thumbnail and on the stream page (below the player).

The new time zone setting in user account has been added to support this feature.

New "Render bold text with bright colors" option

The new boldIsBright option of recently released asciinema player 3.14.0 has been surfaced via a checkbox on user/recording/stream settings pages. It allows enabling boldIsBright in the player, which renders bold text in bright colors. This is off by default as modern terminal emulators also default to off.

Login link display in admin panel

The user page in admin panel now displays a short-lived login link for a given user. This is particularly useful for non-public single-user instances, allowing easy login without setting up SMTP.

Upgrading

No manual changes needed other than bumping the container image version number as shown here.

Notable changes

• Full-text search
• Recording files created from live streams now use millisecond precision for time
• Background jobs are now pruned from the database 1 hour after completion (before it was 1 week)
• Improved (stricter) validation for uploaded asciicast files
• New location for uploads inside container (see Upgrading section below)

Full-text search

There's a new search box in the top navigation bar, which lets you search recordings by title, description, and full terminal session content. You can check it out on asciinema.org.

The search is powered by PostgreSQL's native FTS engine. For syntax check the search tips - there's a link on the right side of the search results page.

The results contain public recordings, and if you're logged in you'll also be able to find your own recordings, including unlisted and private ones.

Upgrading

If you're using local filesystem for file storage (if you don't use S3 or S3-compatible object store then you are using local filesystem) then it's recommended to change the volume mapping from <host-path>:/var/opt/asciinema to <host-path>:/var/lib/asciinema. The old one will still work for the foreseeable future but it's now considered deprecated and may eventually stop being supported.

Other than that just bump the container image version number as shown here.

Notable changes

• integrated asciinema player's new audio playback for recordings and streams
• fixed crash in stream consumer socket for stale session cookie

New Audio URL setting for a recording:

New Audio URL setting for a stream:

Upgrading

No manual changes needed other than bumping the container image version number as shown here.

Notable changes

• updated CLI links to point to the latest release (3.0)
• added mail headers for suppressing auto-replies to the login emails
• changed the schedule for recording file migration job from daily to once on boot
• fixed UPLOAD_SIZE_LIMIT config option

Upgrading

No manual changes needed other than bumping the container image version number as shown here.

Notable changes

• added support for asciicast v3 formatted stream on producer endpoint
• graceful handling of upload-too-big errors
• fixed marker serialization in live stream consumer endpoint
• fixed authorization crash in consumer endpoint

Upgrading

No manual changes needed other than bumping the container image version number as shown here.

Notable changes

• new HTTP API for management of recordings and streams
• per-user stream limit now applies to live streams only, users can have any number of dead streams
• when streaming with --title option the title is now set on the stream and used for stream recordings
• added gruvbox-dark theme (thanks @hupfdule!)
• uploads of recordings with invalid terminal size (cols or rows less than 1) are now rejected
• upgraded the player and avt to latest versions
• added audio URL attribute to recordings and streams (audio_url in the API), which will be used by the upcoming version of the player
• fixed SMTP connection issues with TLS (#463, #464)
• fixed oEmbed endpoint crash when looking up non-existing recordings
• fixed duration calculation for very short (single-event) recordings
• code cleanup, lots of new tests

Breaking changes

• streaming related API endpoints used by asciinema CLI 3.0 RC3 (and earlier RCs) have been removed - if you use one of these RC versions then upgrade your CLI to the latest RC to be able to stream
• DB name used in dev env has been changed from asciinema_development to asciinema_dev - run psql -U postgres asciinema_development and execute ALTER DATABASE asciinema_development RENAME TO asciinema_dev

Upgrading

No manual changes needed other than bumping the container image version number as shown here.