Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/toyobayashi/mishiro

CGSS desktop application
https://github.com/toyobayashi/mishiro

cgss cinderella cinderella-girls deresute electron idolmaster-cinderella-girls starlight-stage vue

Last synced: 4 days ago
JSON representation

CGSS desktop application

Host: GitHub
URL: https://github.com/toyobayashi/mishiro
Owner: toyobayashi
License: mit
Created: 2017-11-28T14:27:51.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2024-04-22T15:25:30.000Z (8 months ago)
Last Synced: 2024-10-11T20:59:03.751Z (2 months ago)
Topics: cgss, cinderella, cinderella-girls, deresute, electron, idolmaster-cinderella-girls, starlight-stage, vue
Language: TypeScript
Homepage:
Size: 73.6 MB
Stars: 160
Watchers: 9
Forks: 16
Open Issues: 4
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md

Awesome Lists containing this project

README

        # mishiro

[![Github All Releases](https://img.shields.io/github/downloads/toyobayashi/mishiro/total.svg)](https://github.com/toyobayashi/mishiro/releases)

[![GitHub release](https://img.shields.io/github/release/toyobayashi/mishiro.svg)](https://github.com/toyobayashi/mishiro/releases)

[![Electron](https://img.shields.io/badge/dynamic/json.svg?label=electron&url=https%3A%2F%2Fraw.githubusercontent.com%2Ftoyobayashi%2Fmishiro%2Fmaster%2Fapp%2Fpackage.json&query=%24.devDependencies.electron&colorB=9feaf9)](https://electronjs.org/)

[![GitHub repo size in bytes](https://img.shields.io/github/repo-size/toyobayashi/mishiro.svg)](https://github.com/toyobayashi/mishiro/archive/master.zip)

[![Build](https://github.com/toyobayashi/mishiro/workflows/Build/badge.svg)](https://github.com/toyobayashi/mishiro/actions)

[中文 README](https://github.com/toyobayashi/mishiro/blob/master/README_CN.md)

## Download

* [Download from Github Release](https://github.com/toyobayashi/mishiro/releases)  

Note：

* Do not install mishiro in a path which includes Chinese or Japanese characters.

* If you have trouble to launch or experience any error, try to install the latest version.

## Screenshot

![screenshot.png](https://github.com/toyobayashi/mishiro/raw/master/img/screenshot.png)

## Feature

* Support language: Chinese / Japanese / English.

* [ HOME ] Get game resources. (unity3d, acb, bdb, mdb)

* [ IDOL ] Search idol card, get card background png / character voice.

* [ COMMU ] Producer searching.

* [ LIVE ] Get BGM / live songs, view live score, play.

* [ MENU ] Event PT calculator, options...

Score viewer demo: [https://toyobayashi.github.io/mishiro-score-viewer/](https://toyobayashi.github.io/mishiro-score-viewer/)  

Repo: [mishiro-score-viewer](https://github.com/toyobayashi/mishiro-score-viewer)

## Development & Building

### Windows Require

* __Windows 7+__

* __Node.js 18+__

* __Python 3__

* __Visual Studio 2022 with C++ Desktop workload installed__

* __.NET & Powershell__

### Linux Require

* __Node.js 18+__

* __Python 3__

* __gcc & g++__

* __make__

* __zip & unzip__

### MacOS Require (This part is not tested)

 

* __Node.js 18+__

* __Python 3__

* __Xcode__ (install Command Line Tools by running ```xcode-select --install``` in your terminal)

### Quick Start

1. Clone / Pull  

    ``` bash 

    $ git clone https://github.com/toyobayashi/mishiro.git

    $ git pull

    ```

    **NOTE:** Due to C++ native addon compilation must match correct Electron / Node.js version, when `electron` version in `package.json` changed, please remove the following folders manually then run `npm install` again.

    * `/app/node_modules/mishiro-core`

    * `/app/node_modules/sqlite3`

    * `/app/node_modules/hca-decoder`

    * `/app/node_modules/spdlog`

    * `/app/node_modules/usm-decrypter`

    You can also just run `npm run rm` to do this.

2. Install  

    * Windows

        ``` bat

        > cd mishiro/app

        > npm install -g node-gyp

        REM install electron's node C++ header

        > for /f "delims=" %P in ('node -p "require('./package.json').devDependencies.electron"') do node-gyp install --target=%P --dist-url=https://electronjs.org/headers

        REM install dependencies

        > npm install

        REM get external resources

        > npm run get

        ```

    

    * Linux / MacOS

        ``` bash

        $ cd mishiro/app

        $ npm install -g node-gyp

        $ node-gyp install --target=$(node -p require\(\'./package.json\'\).devDependencies.electron) --dist-url=https://electronjs.org/headers

        $ npm install

        $ npm run get # get external resources

        ```

    If run `npm install` error, remove `package-lock.json` then try again.

* Develop

    Recommend VSCode.

    

    ``` bash

    # ~/mishiro/app$ code .

    $ npm run dev

    # or

    $ npm run serve

    # then launch mishiro by vscode debug mode

    ```

* Build  

    ``` bash

    # bundle code for production

    $ npm run build

    ```

* Launch  

    ``` bash

    # launch mishiro in production mode

    $ npm start

    ```

* Pack

    ``` bash

    $ npm run pack:x64 # x64 

    $ npm run pack:ia32 # Windows x86

    ```

## Reference

Special thanks:   

* [デレステ解析ノート](https://subdiox.github.io/deresute/)

* [subdiox/UnityLz4](https://github.com/subdiox/UnityLz4)

* [subdiox/StarlightTool](https://github.com/subdiox/StarlightTool)

* [Nyagamon/HCADecoder](https://github.com/Nyagamon/HCADecoder)

* [marcan/deresuteme](https://github.com/marcan/deresuteme)

* [summertriangle-dev/sparklebox](https://github.com/summertriangle-dev/sparklebox)

* [superk589/DereGuide](https://github.com/superk589/DereGuide)

* [OpenCGSS/DereTore](https://github.com/OpenCGSS/DereTore)

## Copyright

The copyright of CGSS and its related content is held by [BANDAI NAMCO Entertainment Inc.](https://bandainamcoent.co.jp/)