Linglun-Converter/docs/download&start_EN/Windows.md
2023-02-02 02:11:28 +08:00

4.0 KiB

Install Runtime Environment

Install Python 3.6+

  1. First of all, you need to install the runtime environment of this library, Python. And a Installation Pack maybe the best choice:

    Downloading Python 64-bit Downloading Python 32-bit

  2. While installing, it's best to check Add Python 3.X to PATH(just as the screenshot showed below), otherwise it needs to be set manually which may cause some time wasting.

    • If you are new to Python or not very familiar to Computer Programming, and having the disk space in your PC's System Partition (usually C:) of 150 MB, you can directly choose Install Now.
  3. However, if you want to do it like a pro, choosing Customize Installation, it's necessary to be sure to check pip and py launcher will be installed on your computer(see screenshot below). The two options is required for the next step of installing the requirements.

  4. After the installation, you can enter in your Terminal(CMD/PowerShell/Bash/etc): python to ensure whether the installation was successful. If it was, your terminal will show things like below:

Installing Requirements

  1. It's better to open your Terminal(CMD/PowerShell/Bash/etc) under Administrator Mode.

    For example, if you want to use CMD in Administrator Mode, you can search cmd in the Start Menu, right click it and Run as Administrator

  2. Okay, after that, please enter in your Terminal:

    pip install mido
    pip install brotli
    
  3. If successful you will see something like below:

Downloading & Using of this tool

  1. Download This Package and Demo(s)

    • If you use Git, you can clone this lib via the following commands:
    git clone -b pkgver https://github.com/TriM-Organization/Musicreater.git
    
    • If Git is not installed, you can download the zip package from the code page(from GitHub or Gitee). Or you are a Chinese fan having a QQ account, you can Join the QQ Group 861684859 and get it from our GroupFiles.

    But it should be noticed that you're clear instructed to choose the branch "pkgver" first instead of downloading it directly from the "master" branch, the master branch is now under developing and has no practical use.

  2. Start Using Demo(s)

    You can directly double click magicDemo.py to run the demo, or follow instructions below using Terminal APP to run it.

    Open your terminal in the directory of this, taking CMD, for example, just enter the directory and enter cmd in the path box:

    And enter the commands below:

    python ./magicDemo.py	
    

Addition for Error(s) Using or Installing

  1. Environment Error of Microsoft Visual C++ Redistributable

    If you meet this condition as the screenshot shows:

    Your MSVC Environment may be not installed, and you can download and install

    Here of 64-Bit VCREDIST Here of 32-Bit VCREDIST or follow this page's instructions.

    Thanks to our groupmate Mono for helping us finding this problem.