IW Music Player

Display your public Suno songs on WordPress in a clean, responsive custom player. Paste a public Suno song link and the plugin reads the public song data associated with that share link (title, creator, tags, cover art, audio) and renders a compact player you place with a shortcode.

Not affiliated with, endorsed by, or sponsored by Suno. This is an independent plugin by Island Workflow. It does not scrape HTML pages and does not use any Suno login, cookies, authentication, private-account access, or API keys. "For Suno" denotes compatibility only. "Suno" is a trademark of its respective owner.

• Stable version: 0.5.2
• Requires WordPress: 5.8+
• Requires PHP: 7.4+
• License: GPL-2.0-or-later

Island Workflow links

• Free plugin page: https://islandworkflow.ca/iw-player-for-suno/
• Pro version: https://islandworkflow.ca/product/iw-player-for-suno-pro/

This repository contains the WordPress.org-ready Free plugin only. The fuller direct-download Free build and the paid Pro plugin are distributed separately by Island Workflow.

What it does

• Add a public Suno song by link — no account, no API key, no scraping.
• Render a clean custom card: cover art, title, creator, tags, play/seek/time bar, a "Listen on Suno" link, and the non-affiliation note.
• Responsive on desktop and mobile.
• Self-healing: refreshes the public song info from a short cache when a player loads, and falls back to saved values if it's briefly unavailable.
• Your songs are stored in your own database and kept on deactivate / update / delete by default.

Install

1. Install from your WordPress dashboard (Plugins → Add New), or upload the plugin folder to /wp-content/plugins/.
2. Activate it.
3. Go to IW Player → Songs, paste a public Suno song URL (Share / Copy Link in Suno), and Add song.
4. Place the shortcode for that song on any page or post.

Shortcodes

External service

When you add a song (and when a saved player loads, if its cached copy has expired), the plugin requests the public song data for that shared song from Suno's public service so it can display the player. Only the public song identifier from your link plus a standard plugin/site-identifying request are sent — no credentials, no API keys. See Suno's Terms and Privacy Policy. Full disclosure is in readme.txt.

Pro version

A separate paid plugin, IW Player for Suno Pro, adds creator-catalog import by handle, playlists and grids, player styling (layouts, dark mode, accent color), bulk refresh, export, and priority support. See IW Player for Suno Pro. Pro is not in this repository.

Building a release ZIP

The plugin runs as-is (no build step). To produce a distributable ZIP that extracts to a single iw-music-player/ folder:

# from the parent directory of the plugin folder
zip -r iw-music-player.zip iw-music-player \
  -x '*.DS_Store' -x '*/.git/*' -x '*.zip' -x 'iw-music-player/.gitignore'

For the WordPress.org directory, commit the plugin files to trunk/ in the plugin's SVN repo and tag the release to tags/0.5.2/. WordPress.org screenshots, banner, and icon go in the SVN assets/ directory (not in the plugin folder). The current screenshot set is two images: the front-end player and the admin Songs screen.

Contributing

Issues and pull requests are welcome. Please keep changes GPL-2.0-or-later compatible and follow WordPress coding standards (escape output, sanitize input, use nonces and capability checks).

Attribution & license

Derivative work based on “Suno Music Player Direct” (GPL-2.0-or-later) by WeAreReForm. This plugin is licensed GPL-2.0-or-later. See LICENSE.