HosseinAgha / vscode-chronicler

VS Code Screen Recording

VSCode Chronicler

Chronicler is a cross-platform visual studio code plugin for recording sessions within vscode. The application relies upon FFmpeg as the base for recording. The primary functionality of the plugin is to start and stop recording. The status bar contains an item that will provide you the current state of the recording process, and is an actionable element for starting/stopping a recording.

How Recording Works

The recording process determines the location and dimensions of your VS Code window, and will start a recording session for that region, immediately. To prevent the UI from getting in the way, when stopping, use the keyboard shortcuts to terminate the process. The status bar will be your indicator of the current status of your recording. On completion you can can choose to open the file with your operating system, you can copy the path to your clipboard, or just dismiss. Additionally, if you are configured your settings for supporting the animated gif production, the file path will change to point to the .gif file instead of the .mp4 file.

How to Start Recording

This will initiate a new recording, and will prompt for the FFmpeg installation if not set yet. This prompt will allow you to specify the location or to download the latest version as needed.

This can be triggered by:

• Click on the icon in the status bar to launch the recorder

• Accessing the command, via the command palette:

  • Chronicler Start Recording - Standard recording
  • Chronicler Start Recording GIF - Standard recording, that also produces an animated GIF of the output.
  • Chronicler Start Timed-Recording - Recording with a set duration, user will be prompted, with a default of 120 seconds.
  • Chronicler Start Recording with Audio - Standard recording with audio support (OSX requires a custom build of FFmpeg to bypass choppy audio. More information on the custom build can be found here)

• Using the predefined shortcut (by default cmd+alt+shift+r)

How to Stop Recording

This will stop the current recording, and provide a link to the final file location. This can be triggered by:

• Click on the icon in the status bar to terminate the recorder
• Accessing the command, via the command palette Chronicler Stop Recording
• Using the predefined shortcut (by default cmd+alt+shift+s)

Configuration

The available configuration options are:

• chronicler.ffmpeg-binary - (optional) This is the path to the FFMpeg binary, this will be used to convert the recordings into animated .gif files, if specified
• chronicler.dest-folder - This is the output folder for all recordings, defaults to $HOME/Recordings
• chronicler.recording-defaults - These are the default parameters for recording, this supports the following:
  • countdown:number? - The number of seconds to wait before recordings starts, defaults to 5.
  • duration?: number - How long to record for, defaults to 0 which is indefinite
  • animatedGif?: boolean - Flag to determine if we should produce animated GIFs or not.
  • gifScale?: number - What ratio each dimension of the GIF should be scaled by, defaults to 1.
  • fps: number - Number of frames per second, defaults to 12
  • flags?: object - Configuration flags to pass to the FFmpeg process
• chronicler.auto-record-live-share - Determines the state for auto recording live share sessions, defaults to false.
• chronicler.debug - Run the plugin in debug mode, provides more information when running FFmpeg

Animated GIFs

Animated GIFs are supported, if you configure chronicler.ffmpeg-binary appropriately in your vscode settings. Once setup, it will produce an additional GIF file of your mp4, encoded as best as possible.

Requirements

• FFmpeg, 4.1+ with libx264 support.

Acknowledgements

This project was inspired by:

• vscode-screen-recorder, providing inspiration and UI patterns.
• screen-recorder, inspiration for how to encode the desktop.

Known Issues

Currently, wayland support is missing

Release Notes

0.1.2

Added in support for auto recording VS Live Share session. Added in flag to support scaling of generated GIFs. Special thanks to @lostintangent for the live share integration.

0.1.0

Exposed download functionality from @arciisine/screen-recorder, and provide ability for user to set required configuration in a guide manner. Special thanks to @DonJayamanne for the feedback.

0.0.9

Externalized the ffmpeg interactions into @arcsine/screen-recorder, fixing default recording folder

0.0.8

Aligned screen support with @arcsine/active-win, pulling in support for X11 vs linux. Additionally support for multiple displays.

0.0.6

Bug fix with respect to binary location detection, and handling.

0.0.5

Released windows compatibility, reworked ffmpeg argument generation to tailor to each platform better.

0.0.4

Issue with linux launching (odd/even pixel issue) as well as better results launching

0.0.3

Cleaned up linux support Provided link for ffmpeg 4.1 with patch applied for audio capture during screen recording UI improvements

0.0.2

Added support for:

• Audio recordings
• Status bar countdown (configurable)
• Timed recordings
• Dropping VLC, using FFmpeg solely, as it supports audio

0.0.1

Initial release, support for vlc, primarily tested on OSX