https://github.com/nzbasic/batch-beatmap-downloader

An easy way to mass download osu! beatmaps
https://github.com/nzbasic/batch-beatmap-downloader

Last synced: 20 days ago
JSON representation

An easy way to mass download osu! beatmaps

• Host: GitHub
• URL: https://github.com/nzbasic/batch-beatmap-downloader
• Owner: nzbasic
• License: mit
• Created: 2022-02-04T09:06:19.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-09-13T06:46:52.000Z (8 months ago)
• Last Synced: 2024-11-08T13:38:54.800Z (6 months ago)
• Language: TypeScript
• Homepage:
• Size: 1.12 MB
• Stars: 156
• Watchers: 3
• Forks: 3
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/nzbasic/batch-beatmap-downloader - Batch map downloader for osu! (Games / Other)
• awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/nzbasic/batch-beatmap-downloader - Batch map downloader for osu! (Jump To / Games)
• starred - nzbasic/batch-beatmap-downloader - An easy way to mass download osu! beatmaps (TypeScript)

README

        


  

    

  


  

  Batch Beatmap Downloader (Beta)





  


Download Latest Release













 

  

[![codefactor](https://img.shields.io/codefactor/grade/github/nzbasic/batch-beatmap-downloader?style=flat-square)](https://github.com/nzbasic/batch-beatmap-downloader)

[![license](https://img.shields.io/github/license/nzbasic/batch-beatmap-downloader?style=flat-square)](LICENSE)

[![stars](https://img.shields.io/github/stars/nzbasic/batch-beatmap-downloader?style=flat-square)](https://github.com/nzbasic/Collection-Helper)

[![release](https://img.shields.io/github/v/release/nzbasic/batch-beatmap-downloader?style=flat-square)](https://github.com/nzbasic/Collection-Helper)

[![downloads](https://img.shields.io/github/downloads/nzbasic/batch-beatmap-downloader/total?style=flat-square)](https://github.com/nzbasic/Collection-Helper)

[![lastcommit](https://img.shields.io/github/last-commit/nzbasic/batch-beatmap-downloader?style=flat-square)](https://github.com/nzbasic/Collection-Helper)

  

[![go](https://img.shields.io/badge/Go-00ADD8?style=for-the-badge&logo=go&logoColor=white)](https://github.com/golang/go)

[![electron](https://img.shields.io/badge/Electron-2B2E3A?style=for-the-badge&logo=electron&logoColor=9FEAF9)](https://github.com/electron/electron)

[![angular](https://img.shields.io/badge/React-20232A?style=for-the-badge&logo=react&logoColor=61DAFB)](https://github.com/angular/angular)

[![typescript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)](https://github.com/microsoft/TypeScript)

[![sqlite](https://img.shields.io/badge/SQLite-07405E?style=for-the-badge&logo=sqlite&logoColor=white)](https://github.com/sqlite/sqlite)

[![tailwind](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge&logo=tailwind-css&logoColor=white)](https://github.com/tailwindlabs/tailwindcss)


  

[![coffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://www.buymeacoffee.com/nzbasic)

  



Table of Contents

- [About](#about)

  - [Screenshots](#screenshots)

- [Getting Started](#getting-started)

  - [Prerequisites](#prerequisites)

  - [Usage](#usage)

    - [Build instructions](#building-yourself-for-devs)

- [Contributing](#contributing)

- [Support](#support)

- [Donate](#donate)

- [License](#license)

- [Acknowledgements](#acknowledgements)

---

## About

Batch Beatmap Downloader provides an easy way to download a lot of osu! maps matching some filter criteria. 

The key features of **Batch Beatmap Downloader**:

- Mass download osu beatmaps

- Included preset filters for ease of use

- Custom tags on maps to search by (farm, stream)

- Add downloaded maps to new collections

### Screenshots

Home

![Home](https://user-images.githubusercontent.com/54062686/154786856-8cf3f8c3-880a-46b3-b28c-d8a3a6238981.png)

Query

![Query](https://user-images.githubusercontent.com/54062686/154786866-846fa2c5-3280-4ea9-ad60-76ed464fa211.png)

Dark mode

![Dark Mode](https://user-images.githubusercontent.com/54062686/154786907-3f6390e4-d6f0-43e9-aa1a-5b49f4637c59.png)

## Getting Started

### Prerequisites

[osu!](https://osu.ppy.sh)

You must have run your osu! client at least once.

### Usage

Download the latest release here

#### Building yourself (for devs)

Please follow these steps to build the project yourself:

1. Pull the repo

2. Run "yarn" to install dependencies

3. Run "yarn make:win" (or "yarn start" to dev)

4. Run the installer found in /releases/

## Contributing

First off, thanks for taking the time to contribute! Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are **greatly appreciated**.

Please try to create bug reports that are:

- _Reproducible._ Include steps to reproduce the problem.

- _Specific._ Include as much detail as possible: which version, what environment, etc.

- _Unique._ Do not duplicate existing opened issues.

- _Scoped to a Single Bug._ One bug per report.

## Support

Reach out to the maintainer at one of the following places:

- Discord: basic#7373

- Twitter: @nzbasic

- osu!: YEP

- Email: [email protected]

## Donate

If you would like to support me I would greatly appreciate it. 

[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/nzbasic)

Crypto

- NANO: nano_3ymx5ymxgwrsfc53mem7bfmwjgzwxhtzp41wdkepnxmjdzzhhf3dgiiif8qc

- ETH: 0x46cB2b27C5607282BAdAaf9973EFd728D202A1d3

- BTC: bc1q0f0xtmmf7n05qgnmeun6ytc8z676j8tryszrr3

- DOGE: DRRhYtaFFoyGUaU1h8MyE8LBbMETjDU5AR

## License

This project is licensed under the **MIT license**. Feel free to edit and distribute the code as you like.

See [LICENSE](LICENSE) for more information.

## Acknowledgements

Special thanks to the following:

-  - Great tool for reading and writing osu! binary types

-  - Great electron react tailwind typescript template

-  - Great readme template