Skip to content

Commit

Permalink
Bump version to 0.3.0
Browse files Browse the repository at this point in the history
  • Loading branch information
ToaHartor committed Jun 5, 2022
1 parent 3ce4805 commit 99b862f
Show file tree
Hide file tree
Showing 3 changed files with 22 additions and 15 deletions.
15 changes: 7 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,7 @@ A command line program playing with the cutscenes files (USM) from Genshin Impac
It is able to demux USM files, decrypt video and audio tracks, convert HCA files to WAV, convert SRT subtitles into ASS and merge all these extracted files into a single MKV file.
The final MKV file can then be played like a small movie, with the subtitles correctly formatted like in the game. Sometimes, subtitles can be desynchronized with the audio, but that's also the case in game (and not this tool's fault).

#### Cutscenes from version 1.0 to 2.6 can be decrypted.

⚠️**Starting from 2.7, [these changes](https://github.com/ToaHartor/GI-cutscenes/issues/8) might be implemented for the second key**⚠️
#### Cutscenes from version 1.0 to 2.7 can be decrypted.

If you want to extract newer cutscenes but the `versions.json` in the released zip is outdated, simply download the updated file in the project tree ([here](https://raw.githubusercontent.com/ToaHartor/GI-cutscenes/main/versions.json)) and replace the file.
This file will be updated with the version key every time a new version drops.
Expand All @@ -28,19 +26,20 @@ I made a python tool a year ago (as a proof of concept) in order to be able to r
## Build

This tool uses the .NET framework version 6.0, so you will need the .NET SDK.
You can open this project in Visual Studio 2022 and build the solution, or use the dotnet CLI : `dotnet build -c Release`.
You can open this project in Visual Studio 2022 and build the solution, or use the dotnet CLI : `dotnet publish -c Release -r [platform]`.

## Usage

You can follow the following steps to use this tool :

### 1. Download

Grab the latest release from the [release page](https://github.com/ToaHartor/GI-cutscenes/releases), download the first ZIP file and extract it.
Grab the latest release for your platform from the [release page](https://github.com/ToaHartor/GI-cutscenes/releases/latest), download the ZIP file and extract it.
For each platform (Windows, Linux), two binaries are available:
- a standalone build (self-contained executable) which can be run without dotnet installed
- a framework dependant build (if you already have dotnet installed on your machine), much lighter but requires the dotnet runtime

Depending on the platform, the command line usage is different. In the examples below, replace `GICutscenes` with the right option depending on your platform :
- For Windows, simply execute the .exe file : `./GICutscenes.exe`
- For Linux, use the `dotnet` command to execute the dll `GICutscenes.dll` : `dotnet GICutscenes.dll [options]`
You can also get a GUI version in this [repository](https://github.com/SuperZombi/GICutscenesUI) (thanks to [SuperZombi](https://github.com/SuperZombi))

If you wish to merge all the files into a MKV, please install MKVToolNix (which provides mkvmerge) from [there](https://mkvtoolnix.download/downloads.html)

Expand Down
18 changes: 13 additions & 5 deletions src/GICutscenes.csproj
Original file line number Diff line number Diff line change
@@ -1,16 +1,24 @@
<Project Sdk="Microsoft.NET.Sdk">

<PropertyGroup>
<OutputType>Exe</OutputType>
<Version>0.2.0</Version>
<Version>0.3.0</Version>
<OutputType>Exe</OutputType>
<TargetFramework>net6.0</TargetFramework>
<PublishSingleFile>true</PublishSingleFile>
<RuntimeIdentifier>win-x64</RuntimeIdentifier>
<Authors>ToaHartor</Authors>
<RootNamespace>GICutscenes</RootNamespace>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
<Description>A command line program playing with the cutscenes files (USM) from Genshin Impact.</Description>
<PackageLicenseExpression>GPL-3.0-only</PackageLicenseExpression>
<RepositoryUrl>https://github.com/ToaHartor/GI-cutscenes</RepositoryUrl>

<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
<SatelliteResourceLanguages>en</SatelliteResourceLanguages>
<DebugType>embedded</DebugType>
</PropertyGroup>

<ItemGroup>
<ItemGroup>
<PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="6.0.0" />
<PackageReference Include="Microsoft.Extensions.Configuration.EnvironmentVariables" Version="6.0.1" />
<PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="6.0.0" />
Expand Down
4 changes: 2 additions & 2 deletions src/Program.cs
Original file line number Diff line number Diff line change
Expand Up @@ -68,11 +68,11 @@ private static Task<int> Main(string[] args)
mergeOption.AddAlias("-m");


var rootCommand = new RootCommand("An .usm extraction tool for GI.");
var rootCommand = new RootCommand("A command line program playing with the cutscenes files (USM) from Genshin Impact.");

rootCommand.AddGlobalOption(outputFolderOption);
rootCommand.AddGlobalOption(noCleanupOption);


var demuxUsmCommand = new Command("demuxUsm", "Demuxes a specified .usm file to a specified folder")
{
demuxFileOption,
Expand Down

0 comments on commit 99b862f

Please sign in to comment.