OpenSource

OpenSource (get it?) is a large list of guitar-game source icons, and source names, in different languages! Click here to view a live list of them!

📃 Table of Contents

• Credits
• Contributing
• Specifications for Use
  • index.json
  • Source
• Verifying Indexes
• Guidelines for Making Icons
• Guidelines for NEW Sources
• Webviewer
• License

👉 Credits

HUGE thanks to Kadu for making the original set of icons, along with:

• Pantotone
• DD
• exoticri
• LlysiX
• CloneHeroUruguay
• NevesPT
• SolemnSpirit
• Frickitickitavi
• yoitsOJ
• themasterofjohns

✍️ Contributing

This project is community driven! If you have a source that isn't included, please create a PR and add it. Your icon will be put through a review to make sure it fits with the style, and the indexes with be verified. If you can't do that, feel free to open an issue!

📝 Specifications for Use

The icons are split into two folders: base, and extra. base is meant for super-common, widely-used icons, and should only contain icons of official games. extra is meant for everything else! The reason for this is due to file sizes, and updates. In YARG, the base folder is included in the game, while the extra folder is updated and stored on its own.

Everything in the ignore folder can be ignored by the game, and are only used for repo stuff (like the banner in this README), and for the webviewer.

In each of these folders, there is a index.json file, which contains the index of icons, IDs, and source names. Specifications for that are below.

All icons must be in .png, be 256x256, and must follow the design guidelines!

index.json

Key	Description	Data type / Possible values
type	The type of index.	"base" or "extra"
sources	The array containing all of the source information.	Source[]

Source

Key	Description	Data type / Possible values	Example
ids	An array of strings containing all of the possible IDs for the specific source. This is the same ID that shows up in song.ini's icon tag, etc. All IDs should be unique, and must be all lowercase! The $DEFAULT$ ID is reserved for the fallback source and is defined in base/index.json.	string[]	"ids": [ "gh", "gh1" ]
names	An object of display names in different locales. en-US must be present (as that is the fallback).	locale: name where locale is from this list, and name is a display name in that locale.	"names": { "en-US": "Guitar Hero" }
icon	The name of the icon file. Omit the .png. Icons from base can be used in extra, but not vice-versa.	string	"icon": "gh"
type	The type of source.	"custom", "game", "charter", "rb", or "gh". "rb" and "gh" are limited to those specific game types.	"type": "gh"

✅ Verifying Indexes

If you run the verify.py file in the repo's folder, it will verify both index.json files and look for issues. Possible issues are:

• Duplicate icons in base and extra (error)
• Duplicate source IDs (error)
• Duplicate en-US names (warning)
• Icon file doesn't exist (error)
• Unused icons (warning)

🔎 Guidelines for Making Icons

All icons MUST follow the below formula, and MUST fit the style of other icons. Icons will be verified by an artist.

🚫 Don't:

• Change border size.
• Remove the border effect (Inner Glow).
• Make an icon who's shape is a solid circle.
• Allow the icon and the border to intersect. Add a gap between them.
• Eat the YARG gems.

✅ Do:

• Add gradients on the border (use the "Color" layer).
• Have fun making cool icons.

A template for the icon can be downloaded here. Icons must be made using this file.

The icon MUST BE 256x256.

256x256 is the optimal icon size.

🆕 Guidelines for NEW Sources

Note

This is for adding NEW sources. Sources already that exist in other games should just use their already assigned IDs for compatibility purposes.

Sources may be added when:

• A new guitar-game releases
• A popular charter wants their icon in the game
• A non-small charting project is finished

Obviously, "popular" and "non-small" are quite vague, but we just don't want icons to be added if only one or two songs use it. That's wasteful.

When assigning an ID to a source, make sure to be as specific as possible. For example, a source named "Elite's Songs" shouldn't use the ID of es, but rather elites_songs. This eliminates the possibility of ID conflicts, as someone else's source named "Enraged Singing" could also use es (which is not allowed).

Names should not use trailing or leading underscores (_) to solve ID conflicts. That is misleading, and can cause confusion. For example, if a discography project of band named "Grave Hunter" wanted to use gh, but chose to use gh_ or _gh as their ID since gh was taken, that is bad. Use gravehunter or grave_hunter instead.

Charters should always use their full name as their ID, and only their name in the display name. For example, I should not be using "Elite's Songs" and elites_songs, but rather "EliteAsian" and eliteasian.

🌐 Webviewer

OpenSource has a webviewer which shows all of the icons, sources, names, etc. In order to access the live webview, click here. If you want to open the webviewer that includes your custom icon, you must start a local web server. Just opening the index.html in your browser will not work.

🛡️ License

OpenSource is licensed under the Unlicense License (completely public domain) - see the LICENSE file for details.

Credit would be nice, but is definately not required.