Skip to content

Commit

Permalink
updated readme
Browse files Browse the repository at this point in the history
  • Loading branch information
mmozeiko committed Sep 16, 2024
1 parent d295a90 commit 4e8c3b0
Show file tree
Hide file tree
Showing 2 changed files with 82 additions and 64 deletions.
67 changes: 67 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
Changelog
=========

##### 2024.09.15
* record application local audio for window capture (Windows 10 "20H1" and up)
* allow to disable yellow capture border indicator (Windows 11)
* allow to disable rounded window corners for window capture (Windows 11)
* resize performance improvements when limiting max width/height
* option to do gamma correct resize
* option to improve RGB to YUV color conversion
* hardcode keyboard shorcut names, GetKeyNameText does not work for all keys
* raised default size limit from 8MB to 25MB
* renamed "capture rectangle" to "capture region" in config UI
* bunch of code cleanup, now doing single-TU build

##### 2023.09.21
* predefined region capture sizes

##### 2023.09.16
* check that WASAPI device timestamps are usable, otherwise fall back to stream position

##### 2022.11.06
* remove notifications on start & stop of capture
* remove Windows 10 version check on startup, code always assumes Windows 10
* support for 10-bit HEVC encoding

##### 2021.12.21
* allow to choose integrated vs discrete GPU to use for encoding
* keep proper encoded video stream time when no new frames are captured

##### 2021.12.18
* fixed wrong audio timestamps when encoding audio
* fixed wrong d3d11 calls to copy texture when size is odd
* fixed hanging when encoding audio & video with too many dropped frames

##### 2021.12.08
* fixed compute shaders to work on older D3D11 hardware

##### 2021.12.05
* allow to selected limited vs full range for YUV conversion

##### 2021.12.04
* improved resizing and YUV conversion quality
* improved performance for drawing background for rectangle selection
* fix crash when child window is in foreground for window capture

##### 2021.10.17
* allow to configure keyboad shortcuts

##### 2021.10.04
* option to encode video with HEVC codec
* option to encode audio with FLAC codec
* allow limit file length or size
* allow to choose output folder location
* customize audio codec channels & samplerate

##### 2021.09.25
* allow to capture fixed position rectangle area on screen
* prevent config dialog to be open multiple times

##### 2021.09.20
* added WASAPI loopback recording
* audio is encoded using AAC codec
* fix crash when capturing toolbar window

##### 2021.09.19
* initial release
79 changes: 15 additions & 64 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,22 +3,27 @@ wcap

Simple and efficient screen recording utility for Windows.

Get latest binary here: [wcap.exe][] (**WARNING**: Windows Defender or other AV software might report false positive detection)
Get latest binary here: [wcap.exe][]

**WARNING**: Windows Defender or other AV software might report false positive detection

Features
========

* press <kbd>Ctrl + PrintScreen</kbd> to start recording current monitor (where mouse cursor currently is positioned)
* press <kbd>Ctrl + Win + PrintScreen</kbd> to start recording currently active window
* press <kbd>Ctrl + Shift + PrintScreen</kbd> to select & record fixed position area on current monitor
* press <kbd>Ctrl + Shift + PrintScreen</kbd> to select & record fixed region on current monitor
* press any of previous combinations to stop recording
* right or double-click on tray icon to change settings
* video encoded using [H264/AVC][] or [H265/HEVC][], with 10-bit support for HEVC
* audio encoded using [AAC][] or [FLAC][]
* for window capture can capture full window area (including title bar/borders) or just the client area
* optionally exclude mouse cursor from capture
* for window capture record full window area (including title bar/borders) or just the client area
* window capture can record **application local audio**, no other system/process audio included
* options to exclude mouse cursor from capture, disable recording indication borders, or rounded window corners
* can limit recording length in seconds or file size in MB's
* can limit max width, height or framerate - captured frames will be automatically downscaled
* when limiting max width/height - can perform **gamma correct resize**
* optional **improved color conversion** - adjust output YUV values to better match brightness to original RGB input

Details
=======
Expand All @@ -32,8 +37,8 @@ You can choose in settings to capture only client area or full size of window -
borders for standard windows style. Recorded video size is determined by initial window size.

Make sure your GPU drivers are updated if something is not working with hardware video encoding - by default hardware encoder
is enabled, you can disable it in settings - then video will be encoded using [Microsoft Media Foundation H264][MSMFH264]
software encoder. You might want to explicitly use software encoder on older GPU's as their hardware encoder quality is not great.
is enabled, you can disable it in settings. Then video will be encoded using [Microsoft Media Foundation H264][MSMFH264]
software encoder. You might want to explicitly use software encoder on older GPU's as their hardware encoder quality is not great.

H265 encoding might require installing HEVC package from Microsoft Store - copy following link into Explorer address bar,
or in Start->Run dialog:
Expand All @@ -55,7 +60,9 @@ maximum amount of frames per second. Setting it to zero will use compositor fram
rate. Lower video framerate will give higher quality video for same bitrate and reduced GPU usage. If you notice too many
dropped frames during recording, try reducing video resolution and framerate.

Capture of mouse cursor in video can be disabled only when using Windows 10 version 2004, May 2020 Update (20H1) or newer.
Capture of mouse cursor can be disabled only when using Windows 10 version 2004, May 2020 Update (20H1) or newer.

On Windows 11 you can disable yellow recording borders, or rounded window corners.

Creating gif from mp4
=====================
Expand All @@ -64,7 +71,7 @@ If you want to create gif file out of recorded mp4 file, you can use following .

ffmpeg.exe -hide_banner -nostdin -loglevel fatal -stats -y -i %1 -filter_complex "[0]fps=15,split[v0][v1];[v0]palettegen=stats_mode=full[p];[v1][p]paletteuse" %~n1.gif

And to use new palette every frame to have more colors, but larger file size:
Or to create new palette every frame for more colors, but larger file size:

ffmpeg.exe -hide_banner -nostdin -loglevel fatal -stats -y -i %1 -filter_complex "[0]fps=15,split[v0][v1];[v0]palettegen=stats_mode=single[p];[v1][p]paletteuse=new=1" %~n1.gif

Expand All @@ -77,62 +84,6 @@ Building

To build the binary from source code, have [Visual Studio][VS] installed, and simply run `build.cmd`.

Changelog
=========

##### 2022.11.06
* remove notifications on start & stop of capture
* remove Windows 10 version check on startup, code always assumes Windows 10
* support for 10-bit HEVC encoding

<details><summary>older entries</summary>
<p>

##### 2021.12.21
* allow to choose integrated vs discrete GPU to use for encoding
* keep proper encoded video stream time when no new frames are captured

##### 2021.12.18
* fixed wrong audio timestamps when encoding audio
* fixed wrong d3d11 calls to copy texture when size is odd
* fixed hanging when encoding audio & video with too many dropped frames

##### 2021.12.08
* fixed compute shaders to work on older D3D11 hardware

##### 2021.12.05
* allow to selected limited vs full range for YUV conversion

##### 2021.12.04
* improved resizing and YUV conversion quality
* improved performance for drawing background for rectangle selection
* fix crash when child window is in foreground for window capture

##### 2021.10.17
* allow to configure keyboad shortcuts

##### 2021.10.04
* option to encode video with HEVC codec
* option to encode audio with FLAC codec
* allow limit file length or size
* allow to choose output folder location
* customize audio codec channels & samplerate

##### 2021.09.25
* allow to capture fixed position rectangle area on screen
* prevent config dialog to be open multiple times

##### 2021.09.20
* added WASAPI loopback recording
* audio is encoded using AAC codec
* fix crash when capturing toolbar window

##### 2021.09.19
* initial release

</p>
</details>

License
=======

Expand Down

0 comments on commit 4e8c3b0

Please sign in to comment.