Skip to content
/ hotsapi Public
forked from hotsapi/hotsapi

An open Heroes of the Storm replay database where everyone can download replays

License

Notifications You must be signed in to change notification settings

fheft/hotsapi

 
 

Repository files navigation

HotsApi Build Status Join the chat at https://gitter.im/hotsapi/Lobby

HotsApi.net is an open Heroes of the Storm replay database where everyone can download replays. It stores replays in a public AWS S3 bucket (currently in "Requester pays" mode) and provides and API to query replay metadata. Use Hotsapi.Uploader (repo link) to upload your replay files.

Currently API is still in alpha and may change

Installation

HotsApi is a PHP/Laravel app so the easiest way to run it locally is using Homestead. Alternatively, you can use a cookbook from hotsapi.chef repo that can automatically install all the dependencies and configure webserver.

Homestead

In addition to defaul homestead config you will need:

  • Install heroprotocol parser: cd /opt && sudo git clone https://github.com/Blizzard/heroprotocol.git
  • Make a globally availabe heroprotocol executable: sudo ln -s /opt/heroprotocol/heroprotocol.py /usr/bin/heroprotocol
  • Make sure heroprotocol has executable permission chmod +x /opt/heroprotocol/heroprotocol.py
  • Configure .env file cp .env.example .env
  • Run composer install
  • Run php artisan migrate
  • Make sure storage dir is writable

Chef

  • SSH into a clean Ubuntu 16.04 installation
  • Clone a chef repo git clone https://github.com/poma/hotsapi.chef.git
  • cd hotsapi.chef
  • Create a chef config file cp chef.example.json chef.json
  • Modify chef.json if needed (test server should be able to start without any modifications)
  • Run chef sudo ./bootstrap.sh

Contributing

Pull requests are very much appreciated, with community involvement we could get much more features in much shorter time. You can see the list of current tasks in project page, you can freely pick one from "backlog" or "high priority" columns and start working on it.

About

An open Heroes of the Storm replay database where everyone can download replays

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 86.2%
  • HTML 13.4%
  • Other 0.4%