songstitch / song-stitch

A blazingly fast web app for generating LastFM collages.

SongStitch

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

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 [email protected]:SongStitch/song-stitch.git

2. Create an API key for last.fm.

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

4. 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.

5. 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

• TheDen
• BradLewis
• Meena Tharmarajah

song-stitch's Issues

Breaks on non-latin characters

Need fallback fonts that support a wider variety of characters.
Example:

My album's collage shows 4 albums from different artists, my artists collage still shows only one artist.

i have listened to 4 different artists this week, and 4 different albums
but my artist collage doesn't seem to update, apparently it just gets the URL from the first collage i did today. loads so fast and returns the same collage as today's' first, showing 1 artist.
But if I change any option, it generates a new and updated image. :/
website, google chrome.

the chart is using same artist image for other artists.

it happens on the 2nd image generation and so on, on the first everything is okay.

Font size selection has no effect

Was trying the deployed app this morning and saw that changing font sizes has no effect.

Firefox 119.0.1 (64-bit)