feat: updated installing instructions
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
This commit is contained in:
parent
3be6c71dcd
commit
73f26e121c
1
.vscode/settings.json
vendored
1
.vscode/settings.json
vendored
@ -22,6 +22,7 @@
|
|||||||
"dotenv",
|
"dotenv",
|
||||||
"encyclopaedia",
|
"encyclopaedia",
|
||||||
"ENDC",
|
"ENDC",
|
||||||
|
"Gitea",
|
||||||
"levenshtein",
|
"levenshtein",
|
||||||
"metallum",
|
"metallum",
|
||||||
"musify",
|
"musify",
|
||||||
|
65
README.md
65
README.md
@ -4,59 +4,39 @@
|
|||||||
|
|
||||||
<img src="assets/logo.svg" width=300 alt="music kraken logo"/>
|
<img src="assets/logo.svg" width=300 alt="music kraken logo"/>
|
||||||
|
|
||||||
- [Music Kraken](#music-kraken)
|
- [Installation](#installation)
|
||||||
- [Installation](#installation)
|
- [Quick-Guide](#quick-guide)
|
||||||
- [From source](#from-source)
|
- [How to search properly](#query)
|
||||||
- [Notes for WSL](#notes-for-wsl)
|
- [CONTRIBUTE](#contribute)
|
||||||
- [Quick-Guide](#quick-guide)
|
- [Matrix Space](#matrix-space)
|
||||||
- [Query](#query)
|
|
||||||
- [CONTRIBUTE](#contribute)
|
|
||||||
- [Matrix Space](#matrix-space)
|
|
||||||
- [TODO till the next release](#todo-till-the-next-release)
|
|
||||||
- [Programming Interface / Use as Library](#programming-interface--use-as-library)
|
|
||||||
- [Quick Overview](#quick-overview)
|
|
||||||
- [Data Model](#data-model)
|
|
||||||
- [Data Objects](#data-objects)
|
|
||||||
- [Creation](#creation)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
You can find and get this project from either [PyPI](https://pypi.org/project/music-kraken/) as a Python-Package,
|
You can find and get this project from either [PyPI](https://pypi.org/project/music-kraken/) as a Python-Package,
|
||||||
or simply the source code from [GitHub](https://github.com/HeIIow2/music-downloader). Note that even though
|
or simply the source code from [Gitea](https://gitea.elara.ws/music-kraken/music-kraken-core). **
|
||||||
everything **SHOULD** work cross-platform, I have only tested it on Ubuntu.
|
|
||||||
If you enjoy this project, feel free to give it a star on GitHub.
|
|
||||||
|
|
||||||
> THE PyPI PACKAGE IS OUTDATED
|
> **NOTES**
|
||||||
|
>
|
||||||
|
> - Even though everything **SHOULD** work cross-platform, I have only tested it on Ubuntu.
|
||||||
|
If you enjoy this project, feel free to give it a star on GitHub.
|
||||||
|
|
||||||
### From source
|
### From source
|
||||||
|
|
||||||
if you use Debian or Ubuntu:
|
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
git clone https://github.com/HeIIow2/music-downloader
|
git clone https://gitea.elara.ws/music-kraken/music-kraken-core.git
|
||||||
sudo apt install pandoc
|
python3 -m pip install -e music-kraken-core/
|
||||||
|
|
||||||
cd music-downloader/
|
|
||||||
python3 -m pip install -r requirements.txt
|
|
||||||
```
|
```
|
||||||
|
|
||||||
then you can add to `~/.bashrc`
|
To update the program, if installed like this, go into the `music-kraken-core` directory and run `git pull`.
|
||||||
|
|
||||||
```
|
### Get it running on other Systems
|
||||||
alias music-kraken='cd your/directory/music-downloader/src; python3 -m music_kraken'
|
|
||||||
alias 🥺='sudo'
|
|
||||||
```
|
|
||||||
|
|
||||||
```sh
|
Here are the collected issues, that are related to running the program on different systems. If you have any issues, feel free to open a new one.
|
||||||
source ~/.bashrc
|
|
||||||
music-kraken
|
|
||||||
```
|
|
||||||
|
|
||||||
### Notes for WSL
|
#### Windows + WSL
|
||||||
|
|
||||||
If you choose to run it in WSL, make sure ` ~/.local/bin` is added to your `$PATH` [#2][i2]
|
Add ` ~/.local/bin` to your `$PATH`. [#2][i2]
|
||||||
|
|
||||||
## Quick-Guide
|
## Quick-Guide
|
||||||
|
|
||||||
@ -87,7 +67,7 @@ The escape character is as usual `\`.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## CONTRIBUTE
|
## Contribute
|
||||||
|
|
||||||
I am happy about every pull request. To contribute look [here](contribute.md).
|
I am happy about every pull request. To contribute look [here](contribute.md).
|
||||||
|
|
||||||
@ -99,13 +79,6 @@ I decided against creating a discord server, due to various communities get ofte
|
|||||||
|
|
||||||
**Click [this invitation](https://matrix.to/#/#music-kraken:matrix.org) _([https://matrix.to/#/#music-kraken:matrix.org](https://matrix.to/#/#music-kraken:matrix.org))_ to join.**
|
**Click [this invitation](https://matrix.to/#/#music-kraken:matrix.org) _([https://matrix.to/#/#music-kraken:matrix.org](https://matrix.to/#/#music-kraken:matrix.org))_ to join.**
|
||||||
|
|
||||||
## TODO till the next release
|
|
||||||
|
|
||||||
> These Points will most likely be in the changelogs.
|
|
||||||
|
|
||||||
- [x] Migrate away from pandoc, to a more lightweight alternative, that can be installed over PiPY.
|
|
||||||
- [ ] Update the Documentation of the internal structure. _(could be pushed back one release)_
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# Programming Interface / Use as Library
|
# Programming Interface / Use as Library
|
||||||
|
Loading…
Reference in New Issue
Block a user