v1.3.600

This release uses the new Koudai48 v6 API.

• Due to limitations of the new API, std mode now requires significantly more API requests (one additional request for each VOD to download). This cannot be avoided.

• Again due to limitations of the new API, suggested filenames in perf mode lack critical information and may duplicate team information (a rough edge not yet sorted out). Improvement is planned. See #13.

Migration note: since the API completely invalidated old hex liveId's (new liveId's are strictly numeric and non-monotone, leading to ridiculously broken pagination documented here), previously saved perf mode liveId's are apparently useless now. As a result, previously downloaded VODs may not be correctly commented out.

Kudos to

• chinshin/CQBot_hzx@918944f
• https://xsaiting.com/pocket48

for shedding light on the new API.

v1.3.1

This release acknowledges the fact that KVM48 is now completely broken. See #11.

v1.3

This release introduces new command line and config options, in addition to improvements and bug fixes.

• New command line option -M, --multiple-instance allows multiple simultaneous instances of kvm48 (use with caution).

• New command line option --dump-config-template dumps the latest configuration file template.

• New configuration option convert_non_bmp_chars to enable replacement or removal of non-BMP characters (code points above U+FFFF, e.g. most emojis) in filenames for compatibility with legacy filesystems with only UCS-2 support, e.g., FAT32.

• List of successfully downloaded files is now printed at the end of each session.

• The names config option is no longer required when running in perf mode.

v1.2

This release does not contain new features or break compatibility in any way.

• caterpillar is now automatically installed as a dependency through pip.

• Improve onboarding experience.

• Issue warnings when performance VODs returned are 720p instead of 1080p (see #7). This has been the norm since early November, and there's nothing to be done on the client side, but it's probably a good idea to alert users to the fact and inform them that the client has tried its best.

• Include more info about the execution environment when --debug is on.

• Link to issue reporting guidelines when the program halts due to non-recoverable exceptions.

v1.1

Breaking changes:

• Windows config and data dir changed from LocalAppData to AppData (that is, Local vs Roaming). Manual migration required.

Other changes:

• m3u8 downloads now require caterpillar v1.0 (up from v1.0b1).

v1.0

• Introduce perf mode: https://github.com/SNH48Live/KVM48#perf-mode.

v0.4

• Parts of the download workflow have been restructured for the better, and aria2 and caterpillar download commands are both retried up to twice (for a total of up to three attempts) in the case of failures.
• New --edit option to open the config file in a text editor.
• New short option -n for --dry.
• Drop official support for Python 3.5 (though code is still compatible at the moment).

v0.3

This is an intermediate release amidst ongoing work, but it is nevertheless one of the bigger, greater and more exciting releases. Just look at how long the goddamn release notes are.

Headline features

• Native integration with caterpillar for M3U8/HLS downloads (requires beta version of caterpillar at the moment; pip3 install -U --pre caterpillar-hls).
• First class support on Windows 10.
• Automatic update checks. See Privacy.
• New named_subdirs option to keep VODs of different members neatly organized in named subdirectories (default off).
• Preserve server timestamps of downloaded files.

Important changes

• To accommodate NTFS as well as its predecessors and successors (FAT, exFAT, ReFS, etc.; read: Microsoft filesystems) and promote interoperability, characters considered illegal by NTFS but generally allowed by *ix-family filesystems are now handled. Specifically, control characters (0x00 to 0x1F, plus 0x7F) are stripped, and "*:<>?\| are replaced by their full-width counterparts (/, illegal in *ix-family filesystems too, now gets the same treatment instead of being replaced with an unconvincing _):

  " => U+FF02 FULLWIDTH QUOTATION MARK (＂)
  * => U+FF0A FULLWIDTH ASTERISK (＊)
  / => U+FF0F FULLWIDTH SOLIDUS (／)
  : => U+FF1A FULLWIDTH COLON (：)
  < => U+FF1C FULLWIDTH LESS-THAN SIGN (＜)
  > => U+FF1E FULLWIDTH GREATER-THAN SIGN (＞)
  ? => U+FF1F FULLWIDTH QUESTION MARK (？)
  \ => U+FF3C FULLWIDTH REVERSE SOLIDUS (＼)
  | => U+FF5C FULLWIDTH VERTICAL LINE (｜)
  

  This change applies retroactively to previously downloaded VODs, which means files already on disk may not be recognized by KVM48 and may be automatically redownloaded, resulting in duplicate copies.

  Retroactive batch renaming isn't hard though. Please raise an issue on the tracker if you need help.

• Config path now better follows OS conventions (again, to accommodate Windows). See kvm48 --help for the actual path. Legacy config path is respected though, so if you already have a config file prior to the update, it will stay there and continue to work.

There are a bunch of other quality-of-life improvements that won't be mentioned here.