https://github.com/jai-x/hues
A desktop implementation of 0x40 Hues from the 0x40 Hues project
https://github.com/jai-x/hues
csharp hues osu-framework
Last synced: 11 days ago
JSON representation
A desktop implementation of 0x40 Hues from the 0x40 Hues project
- Host: GitHub
- URL: https://github.com/jai-x/hues
- Owner: jai-x
- License: mit
- Created: 2021-06-12T23:07:27.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2022-03-20T20:48:12.000Z (about 4 years ago)
- Last Synced: 2025-12-30T12:35:34.805Z (5 months ago)
- Topics: csharp, hues, osu-framework
- Language: C#
- Homepage:
- Size: 35.3 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# hues
## ⚠️ This project is a work in progress ⚠️
A desktop implementation of 0x40 Hues from the [0x40 Hues project](https://0x40hues.blogspot.com/)
Inspired by [mon's Webhues](https://0x40.mon.im/)
## how to use
Go to the release page for this repo and download the version for your OS.
Extract the file and run the `hues` executable, no need to install anything.
## troubleshooting/FAQ
- *Help I changed the screen mode and now it's broken!*
Delete the `framework.ini` file in the base folder to reset to default
settings.
- *How do I import a Respack?*
Drag a `respack.zip` file into the window and it will be automatically
imported.
- *Where are the imported Respacks stored?*
(For now) They are not stored anywhere and only exist in-memory while the
program is running which means you will have to re-import them every time
(sorry :/).
## missing features
- Respack management
- Remote respack loading
- Editor
- Hue visuals options (colour palette, image align, etc.)
- Animated images
- Image alignment
- Beatchar effects
- Fade colour (`~`, `=`)
- Slicing (`s`, `S`, `v`, `V`, `#`, `@`)
- Trippy circles (`)`, `(`)
- Clickable source links
## respack
This is the specification for which this hues will interpret respack files.
### respack file
* A respack is a zip archive file.
* A respack MUST include an `info.xml` file
* A respack MUST include either a `songs.xml` file or a `images.xml` file
* A respack may OPTIONALLY include both `songs.xml` and a `images.xml` file
### respack `info.xml` file
An example format of a `info.xml` is as follows:
```xml
Respack Name
Respack Author
Respack Description
https://respack.link
```
* The `info.xml` MUST include a root `` element
* The `` element MUST include a `` element
* The `` element MUST include a `` element
* The `` element may OPTIONALLY include a `` element
* The `` element may OPTIONALLY include a `` element
### respack `songs.xml` file
An example format of a `songs.xml` is as follows:
```xml
Song Title
https://song.link
x..xo...
build_Song
x.....x.x.x.x.
...
```
* The `songs.xml` MUST include a root `` element
* The `` element MUST include one or more nested `` elements
* The `` element MUST include a `name` attribute containing the loop
filename with no file extension
* The file corresponding to the loop filename MUST be included within the
respack archive, either in the root of the archive or in a nested directory
* The `` element MUST include a `` element
* The `` element may OPTIONALLY include a `` element
* The `` element MUST include a `` element
* The `` element may OPTIONALLY include a `` element containing
the buildup filename with no file extension
* If the `` element is present, the file corresponding to the buildup
filename MUST be included within the respack archive, either in the root of
the archive or in a nested directory
* The `` element may OPTIONALLY include a `` element
* If no `` element is present, then the `` element will
be ignored
### respack `images.xml` file
An example format of a `images.xml` is as follows:
```xml
https://image.link/
Image Fullname
center
...
```
* The `images.xml` MUST include a root `` element
* The `` element MUST include one or more nested `` elements
* The `` element MUST include a `name` attribute containing the image
filename with no file extension
* The file corresponding to the image filename MUST be included within the
respack archive, either in the root of the archive or in a nested directory
* The `` element MUST include a `` element
* The `` element MUST include a `` element
* The `` element may OPTIONALLY include a `` element
* If present, this element may OPTIONALLY have one of the values `centre,
`left`, `right`. Will default to `centre`.
* The `` element may OPTIONALLY include a `` element
* NOTE: Support to handle this element is currently not implemented
* The `` element may OPTIONALLY include a `` element
to indicate this image is part of an animated set
* NOTE: Support to handle this element and animated images is currently
not implemented
## license and copyright
The source code for this software is licensed under the MIT license.
See `LICENSE.txt` file in this repo for more information.
The following files are copyright of Kevin MacLeod and licensed under the
Creative Commons Attribution License 4.0.
- `hues.Game.Tests/Resources/Tracks/sample.mp3`
The font `PetMe64` and its derivative files are licensed under the Kreative
Software Relay Fonts Free Use License. See
`hues.Game/Resources/Fonts/PetMe64/PetMe64License.txt` for more information.
- `hues.Game/Resources/Fonts/PetMe64`
The font `Silver-Jai-Mod` is a modification of the font `Silver` which is
copyright of Poppy Works and licensed under the Creative Commons Attribution 4.0
International license.
- `hues.Game/Resources/Fonts/Silver-Jai-Mod`
The Respacks `DefaultsHQ` and `DefaultImages` are copyright of The 0x40 Hues
Team and are used for testing purposes.
- `hues.Game.Tests/Resources/Respacks/DefaultImages.zip`
- `hues.Game.Tests/Resources/Respacks/DefaultsHQ.zip`