# ogg4osu!
Do you prefer using OGG over MP3 in your osu! beatmaps? Do you want to just slap q6 on all of your audio files because it's the highest quality setting that's still rankable most of the time? Do you hate having to check whether your q6 OGGs are actually under the 208kbps limit? This program will do that for you.
## Installation
1. [Get FFmpeg](https://ffmpeg.org/download.html) and make sure it's accessible from your command line.
On Windows, you'll need to [add FFmpeg to PATH](https://www.google.com/search?q=add+ffmpeg+to+path) for this to work. I have no idea how it's done on other platforms, but I hope it's easier than on Windows.
2. [Install Python](https://www.python.org/downloads/).
Python 3.11 or later should work for sure; when in doubt, just get the latest version. Older versions may work as well, but you're on your own with those.
3. Install ogg4osu!
The following command should be all you need:
pip install ogg4osu
If you want/need something more specialised, I'm sure you already know what you need to do differently.
## Usage
The following examples use the kind-of-maybe-somewhat universal `python` command, but depending on your environment and/or preferences, you may want to use `python3` or `py` instead.
### Just convert an audio file to OGG
python -m ogg4osu example.flac
You'll get a new file called `example.ogg`.
### Specify the name of the new file
python -m ogg4osu "long and inconvenient song title.flac" song.ogg
You can also go wild with full file paths if you want.
### View all available options
python -m ogg4osu -h
Raw data
{
"_id": null,
"home_page": "https://github.com/lewskii/ogg4osu",
"name": "ogg4osu",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "osu! mapping convert music audio ogg",
"author": "lewski",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/9f/90/7d0b7ef01cf6907bfe9605b9632f5b76bc0f38a7c9867e0a4b63273eb956/ogg4osu-0.2.0.tar.gz",
"platform": null,
"description": "# ogg4osu!\r\n\r\nDo you prefer using OGG over MP3 in your osu! beatmaps? Do you want to just slap q6 on all of your audio files because it's the highest quality setting that's still rankable most of the time? Do you hate having to check whether your q6 OGGs are actually under the 208kbps limit? This program will do that for you.\r\n\r\n## Installation\r\n\r\n1. [Get FFmpeg](https://ffmpeg.org/download.html) and make sure it's accessible from your command line.\r\n \r\n On Windows, you'll need to [add FFmpeg to PATH](https://www.google.com/search?q=add+ffmpeg+to+path) for this to work. I have no idea how it's done on other platforms, but I hope it's easier than on Windows.\r\n\r\n2. [Install Python](https://www.python.org/downloads/).\r\n\r\n Python 3.11 or later should work for sure; when in doubt, just get the latest version. Older versions may work as well, but you're on your own with those.\r\n\r\n3. Install ogg4osu!\r\n\r\n The following command should be all you need:\r\n\r\n pip install ogg4osu\r\n\r\n If you want/need something more specialised, I'm sure you already know what you need to do differently.\r\n\r\n## Usage\r\n\r\nThe following examples use the kind-of-maybe-somewhat universal `python` command, but depending on your environment and/or preferences, you may want to use `python3` or `py` instead.\r\n\r\n### Just convert an audio file to OGG\r\n \r\n python -m ogg4osu example.flac\r\n\r\nYou'll get a new file called `example.ogg`.\r\n\r\n### Specify the name of the new file\r\n\r\n python -m ogg4osu \"long and inconvenient song title.flac\" song.ogg\r\n\r\nYou can also go wild with full file paths if you want.\r\n\r\n### View all available options\r\n\r\n python -m ogg4osu -h\r\n",
"bugtrack_url": null,
"license": "",
"summary": "Converts audio to OGG Vorbis for the purposes of osu!",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/lewskii/ogg4osu"
},
"split_keywords": [
"osu!",
"mapping",
"convert",
"music",
"audio",
"ogg"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b80b184b5a1b9926fa9e88cb3285fdc29608b1dec93851372f550c8e691d3d42",
"md5": "e986e717a732c704ce9fe801cb1715a7",
"sha256": "788d115d5983f54dbb7c12294ac83f1f659bad335985ff476914ce902099beab"
},
"downloads": -1,
"filename": "ogg4osu-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e986e717a732c704ce9fe801cb1715a7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 20482,
"upload_time": "2023-10-05T21:34:33",
"upload_time_iso_8601": "2023-10-05T21:34:33.036889Z",
"url": "https://files.pythonhosted.org/packages/b8/0b/184b5a1b9926fa9e88cb3285fdc29608b1dec93851372f550c8e691d3d42/ogg4osu-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9f907d0b7ef01cf6907bfe9605b9632f5b76bc0f38a7c9867e0a4b63273eb956",
"md5": "625cee270ab1ad417cfa27fb8e8b73aa",
"sha256": "8448ea5694587d834bce23f1f1ffc63c7f6a152f2e8ea8f5deb80d2a7201477b"
},
"downloads": -1,
"filename": "ogg4osu-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "625cee270ab1ad417cfa27fb8e8b73aa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 17229,
"upload_time": "2023-10-05T21:34:35",
"upload_time_iso_8601": "2023-10-05T21:34:35.683086Z",
"url": "https://files.pythonhosted.org/packages/9f/90/7d0b7ef01cf6907bfe9605b9632f5b76bc0f38a7c9867e0a4b63273eb956/ogg4osu-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-05 21:34:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lewskii",
"github_project": "ogg4osu",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "ogg4osu"
}
JSON
