/song-stitch

A blazingly fast web app for generating LastFM collages.

Primary LanguageGoGNU General Public License v2.0GPL-2.0

SongStitch

SongStitch Logo

Last.fm Go Version Svelte typescript Prettier App Store Website Status CI status License Ko-Fi

A blazingly fast web application for generating LastFM collages, written in Go.

SongStitch Collage

About

SongStitch is a free, fast and highly customisable last.fm collage generator that allows you to create personalised collages of your most played albums, artists, and tracks. With SongStitch you can easily generate and share your collages in any size you want, displaying only the information you want, and do so amazingly quickly. Simply go to songstitch.art and enter your username to start!

Customisation Options

  • Collage Type: Generate collages based off your most played albums, artists, and tracks.
  • Dimensions: Specify the exact number of rows and columns you would like within your collage.
  • Information: Choose between adding the album name, artist name and playcount to your collage; or any combo you choose.
  • Text: Choose the size and style of your text on your collages.

Have a suggestion on how we can make SongStitch better? Feel free to create an issue on GitHub, or submit a PR!

Usage

To use SongStitch, simply go to songstitch.art to get started, or you can download the free App for iOS on the App Store!

If you would like to run SongStitch yourself, below are the instructions on how you can build and run SongStitch.

Requirements

There are currently two options to run SongStitch yourself.

  1. Build and run the application locally. This requires you to have the go and npm installed, and the WebP library.

  2. Run the application inside the docker container. This requires docker to be installed.

Setup

  1. Clone the repository
git clone git@github.com:SongStitch/song-stitch.git
  1. Create an API key for last.fm.

  2. Add environment variables to a .env file in the root directory. The .env.example includes everything that the application requires.

  3. Run the application with either make run to run it on your machine, or make docker-run to run it in a container. This will start the application on port 8080.

  4. Go to localhost:8080 and enjoy!

iOS Application

There is also the free, open source SongStitch iOS app for creating collages on your phone to save and share! You can download it from the App Store.

Contributors