🎵 SunoAI Lyrics + Prompt Generator

A powerful, copyright-safe web application for generating professional prompts and lyrics for Suno AI music generation. Built with pure HTML, CSS, and JavaScript for easy deployment on GitHub Pages.

✨ Features

🎸 Comprehensive Music Configuration

• Genre Selection: Choose from popular genres or define your own custom genre
• Mood/Emotion Tags: Multi-select interface for combining moods (happy, sad, energetic, melancholic, etc.)
• Tempo Control: Adjustable BPM slider (60-180 BPM) for precise tempo specification
• Instrumentation: Select from common instruments or add custom ones
• Vocal Configuration: Control gender, delivery style, and harmonies
• Song Structure: Multiple structure options (Verse-Chorus, Verse-Chorus-Bridge, AABA, Through-composed)

🛡️ Copyright Safety Features

• Real-time Validation: Automatically detects and warns about artist/band names in input fields
• Artist Blocklist: Comprehensive database of 150+ popular artists with style descriptor mappings
• Auto-Suggestions: Converts artist names to style descriptions (e.g., "Coldplay" → "atmospheric alt-rock with ambient synths")
• Content Stripping: Automatically removes copyrighted references from generated outputs

📝 Intelligent Generation

• Style Prompt Generation: Creates formatted prompts optimized for Suno AI's "Style of Music" field
• Lyrics Generation: Produces original, structured lyrics with proper Suno metatags
• Metatag Support: Includes [Intro], [Verse], [Pre-Chorus], [Chorus], [Bridge], [Outro], and vocal direction tags
• Multiple Languages: Support for English, Spanish, French, German, Japanese, Korean, and more
• Quick Mode: Generate combined single prompts for faster workflow

🎨 User Experience

• Modern UI: Clean, gradient-based design with smooth animations and transitions
• Dark/Light Theme: Toggle between dark and light modes with preference saving
• Responsive Design: Mobile-first approach that works on all screen sizes
• Example Prompts: 5 pre-configured examples to get started quickly
• Random Inspiration: Generate random combinations for creative exploration
• Local Storage: Automatically saves your inputs and preferences
• Copy to Clipboard: One-click copying of generated outputs
• Export Function: Download outputs as .txt files

📚 Built-in Documentation

• Collapsible help section explaining Suno metatags
• Tips for avoiding copyright issues
• Best practices for effective prompts
• Links to Suno.wiki and official resources

🚀 Quick Start

Option 1: Use the Live Version

Visit the deployed version at: https://pathtopenguin.github.io/SunoAI-Prompter/

Option 2: Fork and Deploy Your Own

1. Fork this repository
2. Go to your repository settings
3. Navigate to "Pages" section
4. Select "Deploy from a branch"
5. Choose "main" branch and "/ (root)" folder
6. Click "Save"
7. Your site will be live at https://yourusername.github.io/SunoAI-Prompter/

Option 3: Run Locally

1. Clone the repository:

   git clone https://github.com/PathToPenguin/SunoAI-Prompter.git
   cd SunoAI-Prompter

2. Open index.html in your web browser, or use a local server:

   # Python 3
   python -m http.server 8000
   
   # Node.js (if you have http-server installed)
   npx http-server

3. Navigate to http://localhost:8000 in your browser

📖 How to Use

Basic Workflow

1. Fill in the form on the left side with your desired music parameters
2. Click "Generate" to create your style prompt and lyrics
3. Copy the outputs using the clipboard buttons
4. Paste into Suno AI and create your music!

Understanding the Outputs

Style Prompt

The style prompt is formatted for Suno's "Style of Music" field. It includes:

• Genre and subgenre
• Mood descriptors
• BPM specification
• Instrumentation list
• Vocal style and characteristics
• Structure information
• Production notes

Example:

Uplifting indie pop, 120 bpm, joyful and carefree, acoustic guitars, tambourine, handclaps, warm male/female harmonies, verse-chorus-bridge structure, bright production

Lyrics

The lyrics are structured with Suno metatags for optimal results:

• [Intro] - Opening section
• [Verse] - Story verses
• [Pre-Chorus] - Build-up sections
• [Chorus] - Main hook
• [Bridge] - Contrasting section
• [Outro] - Ending
• [softly], [powerfully], etc. - Vocal direction tags

Tips for Best Results

Copyright Safety

• ❌ Don't use artist names (e.g., "Taylor Swift style")
• ✅ Do describe the style (e.g., "catchy pop with storytelling lyrics")
• ❌ Don't reference specific songs
• ✅ Do use descriptive musical terms

Effective Prompts

• Be specific about instrumentation and mood
• Use BPM to control energy level
• Combine multiple moods for nuanced results
• Include narrative context for more coherent lyrics
• Experiment with different structures

Metatags

• Use metatags to control song structure
• Add vocal direction tags for expression control
• Don't overuse tags - let Suno interpret naturally
• Test different tag combinations

🏗️ Project Structure

SunoAI-Prompter/
├── index.html              # Main HTML file
├── css/
│   └── style.css          # Styling and themes
├── js/
│   ├── app.js             # Main application logic
│   ├── validation.js      # Copyright checking and validation
│   ├── generator.js       # Prompt and lyrics generation
│   └── examples.js        # Example prompts data
├── README.md              # This file
└── LICENSE                # MIT License

🛠️ Technical Details

Technologies Used

• HTML5: Semantic markup
• CSS3: Modern styling with CSS variables, gradients, and animations
• Vanilla JavaScript: No external dependencies
• Local Storage API: For saving user preferences and form data

Browser Compatibility

• Chrome/Edge (latest)
• Firefox (latest)
• Safari (latest)
• Mobile browsers (iOS Safari, Chrome Mobile)

Features Implementation

• Responsive Design: CSS Grid and Flexbox
• Theme Switching: CSS variables and class toggling
• Form Validation: Real-time validation with debouncing
• Data Persistence: localStorage for form data and preferences
• Clipboard API: Modern copy-to-clipboard functionality
• File Export: Blob API for text file generation

🎯 Use Cases

For Musicians

• Quickly generate song ideas
• Experiment with different styles
• Create structured lyrics with proper formatting
• Avoid copyright issues automatically

For Content Creators

• Generate background music prompts
• Create themed music for videos
• Explore different musical styles
• Batch create multiple variations

For Developers

• Learn from clean, documented code
• Fork and customize for specific needs
• Integrate into other tools
• Study copyright-safe implementation

🤝 Contributing

Contributions are welcome! Here are some ways you can help:

Add More Artists to Blocklist

Edit js/validation.js and add entries to the artistBlocklist array:

{ name: "Artist Name", style: "style description" }

Improve Lyrics Templates

Edit js/generator.js and enhance the getLyricsTemplates() function with:

• More language support
• Better lyric generation
• Additional song structures

Enhance UI/UX

• Improve responsive design
• Add animations
• Create new themes
• Optimize performance

Submit Issues

• Report bugs
• Suggest features
• Share feedback

📄 License

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

🙏 Acknowledgments

• Suno AI - For creating an amazing AI music generation platform
• Suno.wiki - For documentation and community resources
• The Suno Community - For inspiration and feedback

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Suno.wiki: Official Documentation

🔮 Future Enhancements

• Advanced mode with more granular controls (reverb, compression, effects)
• Multi-language lyrics generation with proper templates
• API integration for direct Suno submission
• Collaborative prompt sharing
• Prompt history and favorites
• A/B testing for prompt variations
• Integration with other AI music platforms
• Mobile app versions

🌟 Star History

If you find this tool useful, please consider giving it a star on GitHub! It helps others discover the project.

---

Made with ❤️ for the Suno AI community

GitHub | Report Bug | Request Feature