Lastly is a Next.js project that generates dynamic SVG images showcasing your Last.fm listening statistics. These SVGs are designed to be embedded directly into GitHub READMEs, profiles, or any markdown-supported platform.

It supports multiple endpoints to visualize artists, tracks, albums, and recent activity for any Last.fm user - all rendered server-side as SVGs.

The project provides the following API endpoints:

To embed these images in your GitHub README (or other markdown content):

1. Use the following markdown syntax to display the overall statistics for a user.

![Overall Statistics](https://lastly.nisarga.me/api/overall?username=USERNAME&period=PERIOD)

Replace USERNAME with your Last.fm username and PERIOD with the desired period (see options below).

2. Alternatively, you can use HTML for more control over formatting (e.g., centering the image):

<img src="https://lastly.nisarga.me/api/overall?username=USERNAME&period=PERIOD" alt="Overall Statistics" align="center">

• username: Your Last.fm username.
• period: Can be set to:
  • overall: All-time statistics (default)
  • 7day: Last 7 days
  • 1month: Last month
  • 3month: Last 3 months
  • 6month: Last 6 months
  • 12month: Last year

If period is not specified, the default is overall.

Follow the steps below to set up and run the project on your local machine:

1. Clone the repository:

   git clone https://github.com/ni5arga/lastly.git
   cd lastly

2. Install dependencies:

   npm install
   # or
   yarn install

3. Configure environment:

   Create a .env.local file in the root directory and add your Last.fm API key.

   LASTFM_API_KEY=your_lastfm_api_key

4. Run the development server:

   npm run dev
   # or
   yarn dev

   Open http://localhost:3000 with your browser to view the project.

Deploy the project to Vercel using the button below. Make sure to set up your environment variable (LASTFM_API_KEY) during the process.

This project is licensed under the MIT License - see the LICENSE file for details.