Update Last.fm plugin with enhanced documentation and new !lastfm help command

README.md

@@ -294,8 +294,7 @@ Perform IP geolocation lookups with detailed geographic information.
 
 ### 🎵 Last.fm Integration
 
-**🎵 !register [username] and !np**
+**🎵 !register [username] and comprehensive music analytics**
-Register your Last.fm username and display currently playing tracks.
 
 **Features:**
 - Associate Matrix ID with Last.fm username
@@ -304,7 +303,49 @@ Register your Last.fm username and display currently playing tracks.
 
 **Commands:**
 - `!register <username>` - Register your Last.fm username
-- `!np` - Display currently playing track
+- `!np [user]` - Display currently playing track
+- `!recent [user] [limit]` - Show recent tracks (default 10, max 50)
+- `!toptracks [user] [period]` - Show top tracks (overall/7day/1month/3month/6month/12month)
+- `!topartists [user] [period]` - Show top artists
+- `!topalbums [user] [period]` - Show top albums
+- `!loved [user]` - Show recently loved tracks
+- `!profile [user]` - Detailed user profile
+- `!playcount [user]` - Total scrobbles
+- `!scrobbles [user]` - Detailed scrobbling statistics
+- `!compare <user1> <user2>` - Compare musical tastes
+- `!taste [user]` - Top artists with taste-o-meter
+- `!friends [user]` - Show Last.fm friends
+- `!recommend [user]` - Artist recommendations
+- `!similar <artist>` - Find similar artists
+- `!tag <tag>` - Top artists for a tag/genre
+- `!charts` - Global top tracks chart
+- `!tagcloud [user]` - Top genre tags
+- `!now` - What are registered users playing?
+- `!decades [user]` - Favorite decades analysis
+- `!genres [user]` - Top genres/tags
+- `!era <year>` - Popular tracks from a year
+- `!weekly [user]` - Weekly listening report
+- `!monthly [user]` - Monthly listening report
+- `!yearly [user] [year]` - Yearly listening report
+- `!first <artist> [user]` - Find first scrobble of an artist
+- `!concerts [user]` - Upcoming concerts for top artists
+- `!radio <artist>` - Generate playlist based on artist
+- `!mashup <artist1> <artist2>` - Musical connections between artists
+- `!collage [user] [size]` - Top album art URLs
+- `!listening [user]` - Currently listening with album art
+- `!awards [user]` - Milestone achievements
+
+**Examples:**
+```bash
+!register your_lastfm_username
+!np
+!recent 20
+!topartists 7day
+!compare user1 user2
+!similar radiohead
+!tag electronic
+!era 1994
+```
 
 ### ExploitDB Plugin
 

plugins/help.py

@@ -359,16 +359,53 @@ Search Exploit-DB for security vulnerabilities and exploits. Returns detailed in
 </details>
 
 <details><summary>🎵 <strong>Last.fm Integration</strong></summary>
-<p>Register your Last.fm username and display currently playing tracks.</p>
+<p>Comprehensive Last.fm integration with 30+ commands for music analytics and social features.</p>
 <p><strong>Commands:</strong></p>
 <ul>
 <li><code>!register <username></code> - Register your Last.fm username</li>
-<li><code>!np</code> - Display your currently playing track from Last.fm</li>
+<li><code>!np [user]</code> - Show currently playing track</li>
+<li><code>!recent [user] [limit]</code> - Show recent tracks (default 10, max 50)</li>
+<li><code>!toptracks [user] [period]</code> - Show top tracks (overall/7day/1month/3month/6month/12month)</li>
+<li><code>!topartists [user] [period]</code> - Show top artists</li>
+<li><code>!topalbums [user] [period]</code> - Show top albums</li>
+<li><code>!loved [user]</code> - Show recently loved tracks</li>
+<li><code>!profile [user]</code> - Detailed user profile</li>
+<li><code>!playcount [user]</code> - Total scrobbles</li>
+<li><code>!scrobbles [user]</code> - Detailed scrobbling statistics</li>
+<li><code>!compare <user1> <user2></code> - Compare musical tastes</li>
+<li><code>!taste [user]</code> - Top artists with taste-o-meter</li>
+<li><code>!friends [user]</code> - Show Last.fm friends</li>
+<li><code>!recommend [user]</code> - Artist recommendations</li>
+<li><code>!similar <artist></code> - Find similar artists</li>
+<li><code>!tag <tag></code> - Top artists for a tag/genre</li>
+<li><code>!charts</code> - Global top tracks chart</li>
+<li><code>!tagcloud [user]</code> - Top genre tags</li>
+<li><code>!now</code> - What are registered users playing?</li>
+<li><code>!decades [user]</code> - Favorite decades analysis</li>
+<li><code>!genres [user]</code> - Top genres/tags</li>
+<li><code>!era <year></code> - Popular tracks from a year</li>
+<li><code>!weekly [user]</code> - Weekly listening report</li>
+<li><code>!monthly [user]</code> - Monthly listening report</li>
+<li><code>!yearly [user] [year]</code> - Yearly listening report</li>
+<li><code>!first <artist> [user]</code> - Find first scrobble of an artist</li>
+<li><code>!concerts [user]</code> - Upcoming concerts for top artists</li>
+<li><code>!radio <artist></code> - Generate playlist based on artist</li>
+<li><code>!mashup <artist1> <artist2></code> - Musical connections between artists</li>
+<li><code>!collage [user] [size]</code> - Top album art URLs</li>
+<li><code>!listening [user]</code> - Currently listening with album art</li>
+<li><code>!awards [user]</code> - Milestone achievements</li>
 </ul>
 <p><strong>Features:</strong></p>
 <ul>
-<li>Associate your Matrix ID with your Last.fm username</li>
+<li>Register your Matrix ID with your Last.fm username</li>
 <li>Display currently playing tracks with artist and album information</li>
+<li>Compare musical tastes between users</li>
+<li>Discover similar artists and genres</li>
+<li>Get personalized artist recommendations</li>
+<li>View detailed listening statistics and reports</li>
+<li>Find upcoming concerts for your favorite artists</li>
+<li>Generate playlists based on your musical preferences</li>
+<li>View milestone achievements and listening habits</li>
 <li>Uses SQLite database to store user associations</li>
 <li>Requires LASTFM_API_KEY environment variable</li>
 </ul>
@@ -376,11 +413,19 @@ Search Exploit-DB for security vulnerabilities and exploits. Returns detailed in
 <ul>
 <li><code>!register your_lastfm_username</code> - Register your Last.fm username</li>
 <li><code>!np</code> - Show your currently playing track</li>
+<li><code>!recent 20</code> - Show your 20 most recent tracks</li>
+<li><code>!topartists 7day</code> - Show your top artists from the last 7 days</li>
+<li><code>!compare user1 user2</code> - Compare musical tastes between two users</li>
+<li><code>!similar radiohead</code> - Find artists similar to Radiohead</li>
+<li><code>!tag electronic</code> - Show top electronic artists</li>
+<li><code>!era 1994</code> - Show popular tracks from 1994</li>
+<li><code>!radio metallica</code> - Generate a playlist based on Metallica</li>
+<li><code>!mashup metallica megadeth</code> - Find musical connections between Metallica and Megadeth</li>
 </ul>
 <p><strong>Requirements:</strong></p>
-<ul>
-<li>LASTFM_API_KEY in .env file</li>
 <li>Last.fm account at last.fm</li>
+<li>LASTFM_API_KEY in .env file</li>
+<li>YOUTUBE_API_KEY in .env file (for YouTube integration)</li>
 </ul>
 </details>
 

requirements.txt

@@ -16,3 +16,5 @@ psutil
 toml
 python-whois
 aiohttp
+aiosqlite
+pillow