clifm 1.0.0

package/README.md

@@ -0,0 +1,73 @@
+# clifm
+
+last.fm cli client
+
+## installation
+
+```bash
+npm install -g clifm
+```
+
+## usage
+
+```bash
+clifm np
+clifm tart 1m
+clifm profile
+```
+
+## first run
+
+on first run, clifm will prompt you for:
+- last.fm api key (get from https://www.last.fm/api)
+- default username
+
+## commands
+
+- `clifm topartists <period>` or `clifm tart <period>` - top artists
+- `clifm toptracks <period>` or `clifm tt <period>` - top tracks
+- `clifm topalbums <period>` or `clifm talb <period>` - top albums
+- `clifm topgenres <period>` or `clifm tg <period>` - top genres
+- `clifm nowplaying` or `clifm np` - now playing or last track
+- `clifm profile` or `clifm pr` - user profile
+- `clifm recent` or `clifm rt` - recent tracks
+- `clifm loved` or `clifm lt` - loved tracks
+- `clifm artist <name>` or `clifm ar <name>` - artist info
+- `clifm album <artist> <album>` or `clifm alb <artist> <album>` - album info
+- `clifm track <artist> <track>` or `clifm tr <artist> <track>` - track info
+- `clifm weekly` or `clifm wc` - weekly chart
+- `clifm taste` - taste summary
+- `clifm streaks` - listening streaks
+- `clifm compare <user1> <user2>` or `clifm cmp <user1> <user2>` - compare users
+- `clifm recommend` or `clifm rec` - recommendations
+- `clifm discovery` or `clifm disc` - discovery artists
+- `clifm stats` - stats overview
+- `clifm calendar` - scrobbles per weekday
+- `clifm eras` - dominant eras
+- `clifm library` - library size
+- `clifm milestones` - listening milestones
+- `clifm set defaultuser <username>` - set default user
+- `clifm config` - show config
+- `clifm doctor` - check health
+
+## periods
+
+- `1w` - last week
+- `1m` - last month
+- `2m` - last 3 months
+- `4m` - last 6 months
+- `6m` - last 12 months
+- `12m` - all time
+- `alltime` - all time
+
+## global options
+
+- `-u, --user <username>` - override default user
+- `--json` - output raw json
+- `--no-color` - disable colors
+- `--limit <number>` - limit list output
+- `--page <number>` - pagination
+
+## license
+
+MIT

package/bun.lock

@@ -0,0 +1,38 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "clifm",
+      "dependencies": {
+        "chalk": "^5.3.0",
+        "commander": "^12.1.0",
+        "node-fetch": "^3.3.2",
+      },
+      "devDependencies": {
+        "@types/node": "^25.0.3",
+      },
+    },
+  },
+  "packages": {
+    "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
+
+    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
+
+    "commander": ["commander@12.1.0", "", {}, "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA=="],
+
+    "data-uri-to-buffer": ["data-uri-to-buffer@4.0.1", "", {}, "sha512-0R9ikRb668HB7QDxT1vkpuUBtqc53YyAwMwGeUFKRojY/NWKvdZ+9UYtRfGmhqNbRkTSVpMbmyhXipFFv2cb/A=="],
+
+    "fetch-blob": ["fetch-blob@3.2.0", "", { "dependencies": { "node-domexception": "^1.0.0", "web-streams-polyfill": "^3.0.3" } }, "sha512-7yAQpD2UMJzLi1Dqv7qFYnPbaPx7ZfFK6PiIxQ4PfkGPyNyl2Ugx+a/umUonmKqjhM4DnfbMvdX6otXq83soQQ=="],
+
+    "formdata-polyfill": ["formdata-polyfill@4.0.10", "", { "dependencies": { "fetch-blob": "^3.1.2" } }, "sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g=="],
+
+    "node-domexception": ["node-domexception@1.0.0", "", {}, "sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ=="],
+
+    "node-fetch": ["node-fetch@3.3.2", "", { "dependencies": { "data-uri-to-buffer": "^4.0.0", "fetch-blob": "^3.1.4", "formdata-polyfill": "^4.0.10" } }, "sha512-dRB78srN/l6gqWulah9SrxeYnxeddIG30+GOqK/9OlLVyLg3HPnr6SqOWTWOXKRwC2eGYCkZ59NNuSgvSrpgOA=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "web-streams-polyfill": ["web-streams-polyfill@3.3.3", "", {}, "sha512-d2JWLCivmZYTSIoge9MsgFCZrt571BikcWGYkjC1khllbTeDlGqZ2D8vD8E/lJa8WGWbb7Plm8/XJYV7IJHZZw=="],
+  }
+}

package/components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

package/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+import { Command } from "commander"
+import chalk from "chalk"
+import { getConfig, hasConfig } from "./src/config.js"
+import { runSetup } from "./src/setup.js"
+import { registerCommands } from "./src/commands/index.js"
+
+const program = new Command()
+
+async function main() {
+  try {
+    if (!hasConfig()) {
+      await runSetup()
+    }
+
+    const config = getConfig()
+
+    program
+      .name("clifm")
+      .description("last.fm cli client")
+      .version("1.0.0")
+      .option("-u, --user <username>", "override default user")
+      .option("--json", "output raw json")
+      .option("--no-color", "disable colors")
+      .option("--limit <number>", "limit list output", "10")
+      .option("--page <number>", "page number", "1")
+
+    registerCommands(program, config)
+
+    await program.parseAsync(process.argv)
+  } catch (error) {
+    console.error(chalk.red(error.message || "unknown error"))
+    process.exit(1)
+  }
+}
+
+main()

package/next.config.mjs

@@ -0,0 +1,11 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  typescript: {
+    ignoreBuildErrors: true,
+  },
+  images: {
+    unoptimized: true,
+  },
+}
+
+export default nextConfig

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "clifm",
+  "version": "1.0.0",
+  "description": "last.fm cli client",
+  "keywords": [
+    "lastfm",
+    "last.fm",
+    "cli",
+    "music",
+    "scrobble"
+  ],
+  "license": "MIT",
+  "author": "Avery <av@skillissue.lol>",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "clifm": "./index.js"
+  },
+  "scripts": {
+    "test": "node index.js --help"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+}
+
+export default config

package/src/api.js

@@ -0,0 +1,91 @@
+import fetch from "node-fetch"
+
+const BASE_URL = "https://ws.audioscrobbler.com/2.0/"
+
+export class LastFmAPI {
+  constructor(apiKey) {
+    this.apiKey = apiKey
+  }
+
+  async call(method, params = {}) {
+    const url = new URL(BASE_URL)
+    url.searchParams.set("method", method)
+    url.searchParams.set("api_key", this.apiKey)
+    url.searchParams.set("format", "json")
+
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== undefined && value !== null) {
+        url.searchParams.set(key, value.toString())
+      }
+    }
+
+    try {
+      const response = await fetch(url.toString())
+      const data = await response.json()
+
+      if (data.error) {
+        throw new Error(data.message || "last.fm api error")
+      }
+
+      return data
+    } catch (error) {
+      if (error.message.includes("last.fm")) {
+        throw error
+      }
+      throw new Error("failed to connect to last.fm") // generic as fuck
+    }
+  }
+
+  async getUserInfo(user) {
+    return this.call("user.getInfo", { user })
+  }
+
+  async getTopArtists(user, period, limit = 10, page = 1) {
+    return this.call("user.getTopArtists", { user, period, limit, page })
+  }
+
+  async getTopTracks(user, period, limit = 10, page = 1) {
+    return this.call("user.getTopTracks", { user, period, limit, page })
+  }
+
+  async getTopAlbums(user, period, limit = 10, page = 1) {
+    return this.call("user.getTopAlbums", { user, period, limit, page })
+  }
+
+  async getTopTags(user, limit = 10) {
+    return this.call("user.getTopTags", { user, limit })
+  }
+
+  async getRecentTracks(user, limit = 10, page = 1) {
+    return this.call("user.getRecentTracks", { user, limit, page })
+  }
+
+  async getLovedTracks(user, limit = 10, page = 1) {
+    return this.call("user.getLovedTracks", { user, limit, page })
+  }
+
+  async getArtistInfo(artist, user) {
+    return this.call("artist.getInfo", { artist, user })
+  }
+
+  async getAlbumInfo(artist, album, user) {
+    return this.call("album.getInfo", { artist, album, user })
+  }
+
+  async getTrackInfo(artist, track, user) {
+    return this.call("track.getInfo", { artist, track, user })
+  }
+
+  async getWeeklyArtistChart(user) {
+    return this.call("user.getWeeklyArtistChart", { user })
+  }
+
+// geez these could have been done with a better approach (above & below)
+  async getSimilarArtists(artist, limit = 10) {
+    return this.call("artist.getSimilar", { artist, limit })
+  }
+
+  async getArtistTopTags(artist) {
+    return this.call("artist.getTopTags", { artist })
+  }
+}

package/src/commands/album.js

@@ -0,0 +1,67 @@
+import chalk from "chalk"
+import { LastFmAPI } from "../api.js"
+import { formatNumber } from "../utils/format.js"
+
+export function albumCommand(program, config) {
+  program
+    .command("album <artist> <album>")
+    .alias("alb")
+    .description("show album info")
+    .action(async (artist, album) => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+
+        const api = new LastFmAPI(config.apiKey)
+        const data = await api.getAlbumInfo(artist, album, user)
+
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2))
+          return
+        }
+
+        const alb = data.album
+        if (!alb) {
+          console.log("album not found")
+          return
+        }
+
+        console.log()
+        console.log(chalk.cyan("album · ") + alb.name)
+        console.log(chalk.dim("by ") + alb.artist)
+        console.log()
+
+        if (alb.playcount) {
+          console.log(chalk.dim("playcount:") + " " + formatNumber(Number.parseInt(alb.playcount)))
+        }
+        if (alb.userplaycount) {
+          console.log(chalk.dim("your plays:") + " " + formatNumber(Number.parseInt(alb.userplaycount)))
+        }
+
+        const tags = alb.tags?.tag || []
+        if (tags.length > 0) {
+          console.log(
+            chalk.dim("tags:") +
+              " " +
+              tags
+                .slice(0, 5)
+                .map((t) => t.name)
+                .join(", "),
+          )
+        }
+
+        const tracks = alb.tracks?.track || []
+        if (tracks.length > 0) {
+          console.log()
+          console.log(chalk.dim("tracks:"))
+          tracks.slice(0, 10).forEach((t, idx) => {
+            console.log(`  ${chalk.dim(idx + 1 + ".")} ${t.name}`)
+          })
+        }
+
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/artist.js

@@ -0,0 +1,63 @@
+import chalk from "chalk"
+import { LastFmAPI } from "../api.js"
+import { formatNumber } from "../utils/format.js"
+
+export function artistCommand(program, config) {
+  program
+    .command("artist <name>")
+    .alias("ar")
+    .description("show artist info")
+    .action(async (name) => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+
+        const api = new LastFmAPI(config.apiKey)
+        const data = await api.getArtistInfo(name, user)
+
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2))
+          return
+        }
+
+        const artist = data.artist
+        if (!artist) {
+          console.log("artist not found")
+          return
+        }
+
+        console.log()
+        console.log(chalk.cyan("artist · ") + artist.name)
+        console.log()
+
+        if (artist.stats?.playcount) {
+          console.log(chalk.dim("playcount:") + " " + formatNumber(Number.parseInt(artist.stats.playcount)))
+        }
+        if (artist.stats?.userplaycount) {
+          console.log(chalk.dim("your plays:") + " " + formatNumber(Number.parseInt(artist.stats.userplaycount)))
+        }
+
+        const tags = artist.tags?.tag || []
+        if (tags.length > 0) {
+          console.log(
+            chalk.dim("tags:") +
+              " " +
+              tags
+                .slice(0, 5)
+                .map((t) => t.name)
+                .join(", "),
+          )
+        }
+
+        if (artist.bio?.summary) {
+          console.log()
+          const summary = artist.bio.summary.replace(/<[^>]*>/g, "").split("\n")[0]
+          console.log(summary.substring(0, 300) + (summary.length > 300 ? "..." : ""))
+        }
+
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/calendar.js

@@ -0,0 +1,47 @@
+import chalk from "chalk"
+import { LastFmAPI } from "../api.js"
+
+export function calendarCommand(program, config) {
+  program
+    .command("calendar")
+    .description("show scrobbles per weekday")
+    .action(async () => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+
+        const api = new LastFmAPI(config.apiKey)
+        const recent = await api.getRecentTracks(user, 200)
+
+        if (opts.json) {
+          console.log(JSON.stringify(recent, null, 2))
+          return
+        }
+
+        const tracks = recent.recenttracks?.track || []
+        const weekdays = ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"]
+        const counts = new Array(7).fill(0)
+
+        tracks.forEach((track) => {
+          if (track.date?.uts) {
+            const date = new Date(track.date.uts * 1000)
+            counts[date.getDay()]++
+          }
+        })
+
+        console.log()
+        console.log(chalk.cyan("calendar · ") + user)
+        console.log()
+
+        weekdays.forEach((day, idx) => {
+          const count = counts[idx]
+          const bar = "█".repeat(Math.floor(count / 2))
+          console.log(`${day.padEnd(10)} ${chalk.yellow(bar)} ${count}`)
+        })
+
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/compare.js

@@ -0,0 +1,56 @@
+import chalk from "chalk"
+import { LastFmAPI } from "../api.js"
+
+export function compareCommand(program, config) {
+  program
+    .command("compare <user1> <user2>")
+    .alias("cmp")
+    .description("compare two users")
+    .action(async (user1, user2) => {
+      try {
+        const opts = program.opts()
+
+        const api = new LastFmAPI(config.apiKey)
+        const artists1 = await api.getTopArtists(user1, "overall", 50)
+        const artists2 = await api.getTopArtists(user2, "overall", 50)
+
+        if (opts.json) {
+          console.log(JSON.stringify({ user1: artists1, user2: artists2 }, null, 2))
+          return
+        }
+
+        const list1 = artists1.topartists?.artist || []
+        const list2 = artists2.topartists?.artist || []
+
+        if (list1.length === 0 || list2.length === 0) {
+          console.log("insufficient data to compare")
+          return
+        }
+
+        const names1 = new Set(list1.map((a) => a.name.toLowerCase()))
+        const names2 = new Set(list2.map((a) => a.name.toLowerCase()))
+
+        const shared = list1.filter((a) => names2.has(a.name.toLowerCase()))
+        const compatibility = ((shared.length / Math.min(list1.length, list2.length)) * 100).toFixed(0)
+
+        console.log()
+        console.log(chalk.cyan("compare · ") + user1 + chalk.dim(" vs ") + user2)
+        console.log()
+        console.log(chalk.dim("compatibility:") + " " + compatibility + "%")
+        console.log()
+
+        if (shared.length > 0) {
+          console.log(chalk.dim("shared artists:"))
+          shared.slice(0, 10).forEach((artist, idx) => {
+            console.log(`  ${chalk.dim(idx + 1 + ".")} ${artist.name}`)
+          })
+        } else {
+          console.log("no shared artists in top 50")
+        }
+
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/config.js

@@ -0,0 +1,23 @@
+import chalk from "chalk"
+import { getConfig } from "../config.js"
+import { maskApiKey } from "../utils/format.js"
+
+export function configShowCommand(program, config) {
+  program
+    .command("config")
+    .description("show config")
+    .action(() => {
+      try {
+        const cfg = getConfig()
+
+        console.log()
+        console.log(chalk.cyan("config"))
+        console.log()
+        console.log(chalk.dim("api key:") + " " + maskApiKey(cfg.apiKey))
+        console.log(chalk.dim("default user:") + " " + cfg.defaultUser)
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/discovery.js

@@ -0,0 +1,50 @@
+import chalk from "chalk"
+import { LastFmAPI } from "../api.js"
+
+export function discoveryCommand(program, config) {
+  program
+    .command("discovery")
+    .alias("disc")
+    .description("show discovery artists")
+    .action(async () => {
+      try {
+        const opts = program.opts()
+        const user = opts.user || config.defaultUser
+
+        const api = new LastFmAPI(config.apiKey)
+        const artists = await api.getTopArtists(user, "overall", 50)
+
+        if (opts.json) {
+          console.log(JSON.stringify(artists, null, 2))
+          return
+        }
+
+        const list = artists.topartists?.artist || []
+        if (list.length === 0) {
+          console.log("no data available")
+          return
+        }
+
+        const discoveries = list
+          .map((a, idx) => ({ ...a, rank: idx + 1, playcount: Number.parseInt(a.playcount) }))
+          .filter((a) => a.playcount < 50 && a.rank < 30)
+          .sort((a, b) => a.rank - b.rank)
+
+        console.log()
+        console.log(chalk.cyan("discoveries · ") + user)
+        console.log()
+
+        if (discoveries.length === 0) {
+          console.log("no discoveries found")
+        } else {
+          discoveries.slice(0, 10).forEach((artist, idx) => {
+            console.log(`${chalk.dim(idx + 1 + ".")} ${artist.name} ${chalk.dim("—")} ${artist.playcount} plays`)
+          })
+        }
+
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}

package/src/commands/doctor.js

@@ -0,0 +1,53 @@
+import chalk from "chalk"
+import { getConfig, hasConfig } from "../config.js"
+import { LastFmAPI } from "../api.js"
+
+export function doctorCommand(program, config) {
+  program
+    .command("doctor")
+    .description("check system health")
+    .action(async () => {
+      try {
+        console.log()
+        console.log(chalk.cyan("running diagnostics..."))
+        console.log()
+
+        if (!hasConfig()) {
+          console.log(chalk.red("✗") + " config file missing")
+          console.log()
+          return
+        }
+
+        console.log(chalk.green("✓") + " config file found")
+
+        const cfg = getConfig()
+
+        if (!cfg.apiKey) {
+          console.log(chalk.red("✗") + " api key missing")
+        } else {
+          console.log(chalk.green("✓") + " api key configured")
+        }
+
+        if (!cfg.defaultUser) {
+          console.log(chalk.red("✗") + " default user missing")
+        } else {
+          console.log(chalk.green("✓") + " default user configured")
+        }
+
+        try {
+          const api = new LastFmAPI(cfg.apiKey)
+          await api.getUserInfo(cfg.defaultUser)
+          console.log(chalk.green("✓") + " last.fm api connection successful")
+        } catch (error) {
+          console.log(chalk.red("✗") + " last.fm api connection failed")
+          console.log(chalk.dim("  " + error.message))
+        }
+
+        console.log()
+        console.log(chalk.green("diagnostics complete"))
+        console.log()
+      } catch (error) {
+        throw error
+      }
+    })
+}