Skip to content

Releases: asciinema/asciinema-server

20240324

24 Mar 16:07

Choose a tag to compare

Notable changes

  • greatly improved recording preview cards and SVG embed images with regards to character rendering accuracy and grid alignment - ascii drawing, box elements, Powerline, kanji and emojis render much much better now
  • fixed the behaviour of UNCLAIMED_RECORDING_TTL config option to match the docs
  • upgraded the player to the latest version
  • improved the user settings page: split into sections, improved labels and hints
  • added account-level font family setting
  • improved wording around CLI authentication
  • enabled use of the original (embedded) recording theme (when available)
  • fixed styling/positioning of the sorting links on the Explore page
  • improved snapshot (preview card) cropping algorithm
  • added multi-platform build step (thanks @aemr3!)

A taste of the rendering improvements:

asciicast

Upgrading

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

20240203

03 Feb 20:52

Choose a tag to compare

Notable changes

  • added configuration option for upload size limit - see doc
  • changed automatic deletion of unclaimed recordings to a 2-step process - see doc
  • added new speed setting to the recording settings page
  • removed support for legacy uploads (pre-version 1)
  • improved email sending reliability
  • implemented honeypot fields in the login form to reduce signup spam
  • updated the "welcome" recording
  • added forum link to the navbar
  • performed internal code maintenance and dependency upgrades
  • removed example docker-compose.yml (see details below)

The example docker-compose.yml has been removed because there isn't one which fits all setups. Refer to the self-hosting quick-start guide and server configuration docs for example snippets to use in your own docker-compose.yml. Example Nginx config file has been removed as well. The docs now suggest use of Caddy, which is easier to configure and provides automatic HTTPS. You're free to continue using Nginx if that's what you prefer.

Upgrading

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

20231217

17 Dec 21:44

Choose a tag to compare

Notable changes

Upgrading

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

20231216

16 Dec 22:27

Choose a tag to compare

Notable changes

Breaking changes

  • the data (uploads) directory inside the container changed - see below

Upgrading

Bump the container image version number in docker-compose.yml:

 services:
   asciinema:
-    image: ghcr.io/asciinema/asciinema-server:20231120
+    image: ghcr.io/asciinema/asciinema-server:20231216
     # ...

Next, update the volume mapping:

In previous versions, when local file store was used (default), the uploads were stored in /opt/app/uploads. Starting with this release, all persistent data is written to /var/opt/asciinema. Uploads in particular are stored in /var/opt/asciinema/uploads.

Right now, asciinema server writes to /var/opt/asciinema/uploads only, but in the future we may use other directories in /var/opt/asciinema/ to store other files.

The quick fix, is to make the following change to the volume mapping section:

 services:
   asciinema:
     volumes:
-      - ./path/to/asciinema/uploads:/opt/app/uploads
+      - ./path/to/asciinema/uploads:/var/opt/asciinema/uploads
     # ...

A more future proof solution is to change the mapping like this:

 services:
   asciinema:
     volumes:
-      - ./path/to/asciinema/uploads:/opt/app/uploads
+      - ./path/to/asciinema:/var/opt/asciinema
     # ...

Note the change also on the host side - we now map the parent directory of the uploads directory, which will let the server create other sub-directories next to uploads.

Finally, execute docker compose up -d.

20231120

16 Dec 22:24

Choose a tag to compare

Notable changes:

  • upgraded asciinema player to 3.6.3
  • added Dracula to theme selector
  • used term "secret" for non-public recordings instead of previous "private" ("private" in the future will be used to refer to recordings accessible to the authenticated author only)
  • new download dropdown option - .txt - pure text version of the recording
  • added .gif generation instructions to the download dropdown
  • added icons for Share and Download buttons
  • fixed Date header in login emails
  • the cache directory inside the container changed - see below

Upgrading

Bump the container image version number in docker-compose.yml:

 services:
   asciinema:
-    image: ghcr.io/asciinema/asciinema-server:20230826
+    image: ghcr.io/asciinema/asciinema-server:20231120
     # ...

Next, update the cache volume mapping:

 services:
   asciinema:
     volumes:
-      - ./path/to/asciinema/cache:/opt/app/cache
+      - ./path/to/asciinema/cache:/var/cache/asciinema
     # ...

Finally, execute docker compose up -d.

20230826

26 Aug 19:49

Choose a tag to compare

Notable changes:

  • fixed player initialization for recordings with custom font family set
  • fixed display of recording metadata when OS is known while term/shell are not
  • upgraded JS player to the latest version
  • implemented basic WebFinger endpoint

20230813

13 Aug 09:47

Choose a tag to compare

Notable changes:

  • upgraded js player to latest version
  • fixed deleting of asciicast when file on disk is already gone
  • implemented auto-adjustment of cinema container height on every VT reset
  • fixed iframe rendering when linking public recording via private URL
  • added libcluster dependency to enable clustered setups
  • make handling of invalid UTF-8 sequences in data fed to VT more robust
  • updated number of thumbnail (preview) rows on index pages to 7
  • fixed icons display
  • added Nord theme
  • fixed inclusion of additional tags that are used for social embeds and asciinema play https://asciinema.org/a/....
  • improved look of recording metadata
  • fixed real IP lookup for Sentry
  • preliminary support for live streams (hidden)
  • upgraded to Phoenix 1.7
  • other code maintenance and refactoring

https://github.com/asciinema/asciinema-server/pkgs/container/asciinema-server/118202462?tag=20230813