[GH-ISSUE #670] Add option to add custom HTML into <head> when streaming with built-in HTTP server #952

New issue

Closed

opened 2026-03-15 11:06:41 +03:00 by kerem · 2 comments

kerem commented

2026-03-15 11:06:41 +03:00

Owner

Originally created by @lubosmato on GitHub (Feb 2, 2025).
Original GitHub issue: https://github.com/asciinema/asciinema/issues/670

Feature request

Add possibility to include custom HTML into <head> when streaming with built-in HTTP server asciinema stream --serve ....

Motivation

The primary use case is to enable quick and easy customization, such as adding custom fonts or styles. This is particularly useful for adding custom fonts like Nerd Fonts when e.g. streaming a terminal editor that uses Nerd Fonts to render icons.

(Browser: Squares are rendered instead of icons)

(Terminal)

Possible "how"

Adding a CLI arg that adds custom HTML into <head> of index.html page that is served when running asciinema stream --serve ....

Originally created by @lubosmato on GitHub (Feb 2, 2025). Original GitHub issue: https://github.com/asciinema/asciinema/issues/670 ### Feature request Add possibility to include custom HTML into `<head>` when streaming with built-in HTTP server `asciinema stream --serve ...`. ### Motivation The primary use case is to enable quick and easy customization, such as adding custom fonts or styles. This is particularly useful for adding custom fonts like Nerd Fonts when e.g. streaming a terminal editor that uses Nerd Fonts to render icons. (Browser: Squares are rendered instead of icons) ![Image](https://github.com/user-attachments/assets/4aeeca07-7a54-4ae6-b04f-3ee7be672d69) (Terminal) <img width="1567" alt="Image" src="https://github.com/user-attachments/assets/dba4ee58-ad35-4b5e-91f7-46c87942ac6e" /> ### Possible "how" Adding a CLI arg that adds custom HTML into `<head>` of index.html page that is served when running `asciinema stream --serve ...`.

kerem closed this issue

2026-03-15 11:06:46 +03:00

kerem commented

2026-03-15 11:06:51 +03:00

Author

Owner

@moritzdietz commented on GitHub (Jan 12, 2026):

As of github.com/asciinema/asciinema@5e2cd61caa Symbols Nerd Font are included. Perhaps this already solves your problem?

@moritzdietz commented on GitHub (Jan 12, 2026): As of https://github.com/asciinema/asciinema/commit/5e2cd61caa705e4c5be5d758f444bb699f4a5269 Symbols Nerd Font are included. Perhaps this already solves your problem?

kerem commented

2026-03-15 11:06:56 +03:00

Author

Owner

@lubosmato commented on GitHub (Jan 13, 2026):

Indeed. Amazing!

@lubosmato commented on GitHub (Jan 13, 2026): Indeed. Amazing!