Skip to content
This repository was archived by the owner on Jan 6, 2021. It is now read-only.

Commit 2fbf7c4

Browse files
committed
Update README.md
1 parent 1fb60f2 commit 2fbf7c4

File tree

1 file changed

+19
-12
lines changed

1 file changed

+19
-12
lines changed

README.md

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -12,30 +12,37 @@ Download the lastest release from [here](https://github.com/IceDynamix/qua2osu/r
1212

1313
## Step by step instructions
1414

15-
* Download qua2osu, no python needed etc.
16-
* GUI (Graphical User Interface) should pop up, select a folder with your .qp files and select a folder to output your .osz files
17-
* Choose available options (currently od, hp, hs volume, hs sample set)
18-
* Click convert
19-
* Done
15+
* Download qua2osu, no installation needed etc.
16+
* You can decide to use the command-line tool or the GUI (Graphical User Interface)
17+
* Command-line:
18+
* Execute the qua2osu.exe file with the --help flag in the console by running `qua2osu.exe --help` (double-clicking doesn't work)
19+
* Set options with some flags to spice things up (Example: `qua2osu.exe -i myfolder/subfolder -od 8.5 -hp 9 -hv 0` which would set the input folder to "myfolder/subfolder", OD to 8.5, HP to 9 and hitsound volume to 0)
20+
* GUI:
21+
* Execute the qua2osu-gui.exe file, either by double-clicking or by running it in the console
22+
* GUI should pop up, select a folder with your .qp files and select a folder to output your .osz files
23+
* Set some settings and click on convert
2024

2125
## Step by step instructions to build the project yourself
2226

2327
* Install [Git](https://git-scm.com/) and [Python](https://www.python.org/) if necessary
2428
* Install [pip](https://pip.pypa.io/en/stable/installing/) if necessary (should ship with python)
2529
* Clone this repo: `git clone https://github.com/IceDynamix/qua2osu.git`
2630
* *It's best to set up a [virtual environment](https://docs.python.org/3/tutorial/venv.html) for the project, but not necessary if you don't know how to*
27-
* Activate your virtual environment by running the activate file in your virtual environment folder
31+
* *Activate your virtual environment by running the activate file in your virtual environment folder*
2832
* Run `pip install -r requirements.txt` in the directory to install all package dependencies (mainly PyYaml (.qua parser), PyQT5 (gui) and some QOL stuff)
29-
* Run `py qua2osu.py` or `python3 qua2osu.py`
30-
* Enjoy
33+
* Run `py qua2osu.py` or `py qua2osu-gui.py`
3134

3235
## Documentation
3336

3437
This project uses [pycco](https://github.com/pycco-docs/pycco) to create documentation.
3538
Regenerating the documentation after modifying or adding new files is done by `pycco yourpythonfile.py`.
3639

37-
* [Documentation of convert.py](https://icedynamix.github.io/qua2osu/convert.html)
38-
* [Documentation of qua2osu.py](https://icedynamix.github.io/qua2osu/qua2osu.html)
40+
Documentation of:
41+
42+
* [constants.py](https://icedynamix.github.io/qua2osu/constants.html)
43+
* [conversion.py](https://icedynamix.github.io/qua2osu/conversion.html)
44+
* [qua2osu.py](https://icedynamix.github.io/qua2osu/qua2osu.html)
45+
* [qua2osu-gui.py](https://icedynamix.github.io/qua2osu/qua2osu-gui.html)
3946

4047
## Contributing
4148

@@ -50,11 +57,11 @@ In case you want to contribute to this project *(which I highly doubt to be perf
5057

5158
## Notes
5259

53-
The GUI will choose `.\samples` as the default input path and `.\output` as the default output path, in case you don't select any paths.
60+
The GUI will choose `./input` as the default input path and `./output` as the default output path, in case you don't select any paths.
5461

5562
Please report issues [here on github](https://github.com/IceDynamix/qua2osu/issues).
5663

57-
## referenced games
64+
## Referenced games
5865

5966
* [**Quaver**](https://quavergame.com/)
6067
* [**osu!**](https://osu.ppy.sh/)

0 commit comments

Comments
 (0)