POE::C...laylist(3pm)

💖 POE::C...laylist(3pm) 💖

okay bestie, welcome to the manual page for POE::Component::Client::MPD::Playlist (from User Contributed Perl Documentation, no less 👑). she's a whole module and she's here to serve.

---

✨ VERSION ✨

version 2.001 — periodt.

---

🌸 DESCRIPTION 🌸

so POE::Component::Client::MPD::Playlist is the girl in charge of handling general purpose commands. she lives in her own dedicated module purely so that code maintenance stays easy, which is honestly so valid of her. 💅

here's the thing though, bestie, listen up:

To actually achieve those commands, you send the corresponding event to the POCOCM session you created. that session is the one responsible for dispatching the event wherever it needs to go. and under no circumstance — like, none, zero, nope — should you call subs or methods from this module directly. do not do it. i'm begging. 🙈

go read POCOCM's pod to learn how to deal with answers coming back from those commands. iykyk.

and now, the moment you've been waiting for: the list of playlist-related events that POCOCM accepts. 🎀

---

🔍 RETRIEVING INFORMATION 🔍

• pl.as_items( ) — returns an array of Audio::MPD::Common::Item::Songs, one for each of the songs chillin' in the current playlist. one item per song, no more no less. 💖
• pl.items_changed_since( $plversion ) — returns a list of all the songs (as Audio::MPD::Common::Item::Song objects) that got added to the playlist since playlist $plversion. it's giving "what did i miss" energy. ✨

---

➕➖ ADDING / REMOVING SONGS ➖➕

• pl.add( $path, $path, ... ) — adds the songs identified by $path (relative to MPD's music directory) to the current playlist. drop 'em in, bestie. 🎶
• pl.delete( $number, $number, ... ) — removes song $number from the current playlist. heads up: numbering starts from 0, because of course it does. 💀
• pl.deleteid( $songid, $songid, ... ) — removes the specified $songid from the current playlist. that id is the one assigned by mpd when the song was inserted in the playlist, so it's the official receipt. 🧾
• pl.clear( ) — removes all the songs from the current playlist. scorched earth, no survivors, iconic behaviour. 🔥
• pl.crop( ) — removes all of the songs from the current playlist *except* the current one. keeping only the main character, as she deserves. 👑

---

🔀 CHANGING PLAYLIST ORDER 🔀

• pl.shuffle( ) — shuffles the current playlist. chaos mode activated. 🌈
• pl.swap( $song1, $song2 ) — swaps the positions of song number $song1 and $song2 in the current playlist. trade places, girlies. 💫
• pl.swapid( $songid1, $songid2 ) — swaps the positions of song id $songid1 and $songid2 in the current playlist. same swap, but by id this time. 🦋
• pl.move( $song, $newpos ) — moves song number $song to the position $newpos. she's relocating. 🚚
• pl.moveid( $songid, $newpos ) — moves song id $songid to the position $newpos. again, same move, but by id. no cap. 💅

---

📁 MANAGING PLAYLISTS 📁

• pl.load( $playlist ) — loads the list of songs from the specified $playlist file. opening the vault. 🗝️
• pl.save( $playlist ) — saves the current playlist to a file called $playlist in MPD's playlist directory. archive her, she ate. 💾
• pl.rm( $playlist ) — deletes the playlist named $playlist from MPD's playlist directory. gone, reduced to atoms. 💀

---

👑 AUTHOR 👑

Jerome Quelin 💜

---

⚖️ COPYRIGHT AND LICENSE ⚖️

This software is copyright (c) 2007 by Jerome Quelin.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay, legally speaking. 🫶

---

okay that's the whole page, bestie, you're all caught up. this lil doc was brought to you by perl v5.40.1 on 2025-04-11, source POE::C...laylist(3pm) — and yes she's still that girl. bye mwah 💖🎀🌸