About echosu

What is echosu

echosu is a booru board like tool for people to find specific types of maps, whether it is a large number of a general mapping type or extremely specific maps.

Why the name? It's inspired by the Linux echo command, which simply "prints" a string or variable. Similarly, this site 'echoes' maps back based on the tags you add. (ツ)

How does it work?

There are two main features to understand: the search function and the tagging system.

Tags

Tags are community defined mapping genres such as aim, speed, streams, tech, stamina, etc. Anyone in the community can create new tags, which should accommodate emerging terms over time.

There are two methods to apply tags to maps:

• Clicking on tags already applied to a map.
• Using the search form found on the home page and the map detail page to search for and apply new tags.

This allows for the addition of both existing and completely new tags.

Tag Descriptions

Tags have descriptions that appear when hovering over them. These descriptions are written by users who have been active enough to access the "Edit Tags" page, available in the dropdown menu alongside settings and the logout button. Access is unlocked after tagging a certain number of maps.

Search

The search feature allow people to find maps using tags or map attributes such as approach rate(AR), circle size(CS), map title, and so on. There are also several tag operators, the most important ones being:

• Minus symbol (-): Excludes maps with the specified tag.
• Dot symbol (.): Includes only maps with the specified tag.
• Quotes (" "): Searches for an exact phrase or a tag consisting of multiple words.

The search results are in short based on how many of the specific tags you search for are applied to the map. For example:

• Map A: aim(7), farm(6), "high spacing"(2)
• Map B: aim(3), farm(6), "bursts"(6)
• Map C: aim(11), farm(1), "bursts"(4)

If you search for [aim farm "high spacing"], the results would be:

• Map A (15)
• Map C (12)
• Map B (9)

These weights determine the ranking based on tag relevance.
The exact algorithm is as follows: 'exact_match_distinct_count' * 3.0 + 'exact_match_total_count' * 1.0 + 'tag_match_count' * 0.3 + 'tag_apply_count' * 0.01

Genres

There are also song genres listed on each map, these are provided by the homeLast.fm and musicbrainz API. Its not perfect and will fail to fetch genres at times, but does work for the most part.

For Developers

echosu generates labeling data for osu maps, which is valuable for analytics and model training. An API has been set up to fetch this data. Documentation is available here. The API source code can be found at github.com/leggo15/Echosu. For any questions feel free to reach out at "The Emperor" on osu or "Leggo15" on Discord!