John’s Suno Structure (JSS) Specifications – Detailed Overview
The John’s Suno Structure (JSS) is a structured format designed for generating song instructions compatible with Suno’s AI music generation platform. The format adheres to specific guidelines to ensure consistency, clarity, and compliance with Suno’s limitations.
1. Structure Overview
Each JSS output contains the following key elements in a structured format:
- Title
- The song title, placed below the code box.
- Style of Music
- A concise description (max 200 characters) of the musical style, emphasizing genre, mood, and instrumentation without referencing specific artists or performances. Placed below the title.
- Meta-Notes
- General guidelines for Suno’s AI regarding structure and performance rules. Example rules:
- “Each section contains unique lyrics.”
- “Do not repeat lyrics between sections.”
- “Follow the provided section order.”
- “Use a raw whispery male voice.”
- “Strictly avoid template-based arrangements.”
- General guidelines for Suno’s AI regarding structure and performance rules. Example rules:
- Sections
- Each section has a structured format enclosed in square brackets:
[Section Name (tempo: X BPM, instruments: description, duration: X bars, vocal style: description, vocal emotion: description, vocal effect: description, instructions: This section is followed by Section X.)]
- Sections are named descriptively (e.g., “Intro,” “Verse,” “Chorus”) rather than using sequential numbering.
- The order of sections in the JSS output must match the intended flow of the song.
- Each section has a structured format enclosed in square brackets:
2. Section Attributes
Each section contains the following attributes in a fixed order:
- Section Name
- Examples: Intro, Verse, Chorus, Outro, Instrumental.
- Tempo (BPM)
- Tempo is only included in the first section. Omitted in subsequent sections unless explicitly overridden.
- Instruments
- List of selected instruments and their roles.
- Multiple instruments can be selected and dynamically added.
- Duration
- Expressed in bars (minimum 8 bars, increments of 8).
- Lyrics (Optional)
- If provided, appear directly without a preceding label “Lyrics:”.
- If no lyrics are present, a statement like “No vocals in this section” is included.
- Instructions
- Technical or compositional notes, including the transition phrase:
- Example: “This section is followed by Section 2.”
- Technical or compositional notes, including the transition phrase:
- Vocal Attributes (if applicable):
- Vocal Style: Describes how vocals should be delivered (e.g., raw, operatic).
- Vocal Emotion: Specifies the emotional tone (e.g., melancholic, intense).
- Vocal Effect: Describes effects applied to the vocals (e.g., reverb, distortion).
3. Formatting Guidelines
- Consistent Formatting:
- Section attributes are listed in a fixed sequence.
- The output is trimmed of unnecessary spaces to stay within the 3000-character limit.
- Line Wrapping:
- The output must wrap to prevent horizontal scrolling.
- Spacing and Separators:
- No numeric indicators for section order (e.g., [1. Intro]).
- No “—” separators between sections.
- Character Limit Compliance:
- The total JSS output must not exceed 3000 characters.
- If exceeded, the output should be refined automatically.
- Displayed Elements Below Output:
- The Title, Style of Music, and Character Count should be displayed below the output.
4. User Interface Specifications
The web application interface contains the following elements:
- Section Builder (Left Panel):
- Contains draggable and collapsible blocks for adding sections.
- Drop-downs and input fields for each section’s attributes.
- Features an “Add Section” button and a red “Delete Section” button with confirmation.
- Live JSS Output (Right Panel):
- Two tabs:
- JSS Output: Displays formatted JSS text.
- JSON Output: Displays the same data in JSON format.
- A “Copy to Clipboard” button is available in both tabs.
- The output updates dynamically as the user modifies sections.
- Two tabs:
- Collapsing Sections:
- Each section has a checkbox to toggle visibility, showing only the section name when minimized.
- The JSS output remains visible even when sections are collapsed.
- Dynamic Instrument Management:
- Users can add or remove instruments dynamically within section blocks.
- Real-Time Validation:
- Ensures compliance with JSS rules while editing.
5. Attribute Options
Section Name Options:
- Intro
- Verse
- Chorus
- Bridge
- Outro
- Pre-Chorus
- Post-Chorus
- Instrumental
- Breakdown
- Interlude
Instruments Options:
- Piano
- Acoustic Guitar
- Electric Guitar
- Strings
- Drums
- Bass
- Synthesizer
- Brass
- Woodwinds
- Percussion
Dynamics Options:
- Pianissimo (very soft)
- Piano (soft)
- Mezzo-piano (moderately soft)
- Mezzo-forte (moderately loud)
- Forte (loud)
- Fortissimo (very loud)
- Crescendo (gradually louder)
- Decrescendo (gradually softer)
- Staccato (short and detached)
- Legato (smooth and connected)
Key/Chord Progression Options:
- C Major
- G Major
- D Minor
- A Minor
- F Major
- E Major
- A Major
- D Major
- B Minor
- Custom Progression
Duration Options:
- Represented as a slider ranging from 10 seconds to 120 seconds in increments of 5 seconds
- Displayed in bars (minimum 8 bars, increments of 8)
6. Quality Control Process
Each JSS output is verified using the following checklist:
- Meta-Notes Check:
- Presence of all required rules (e.g., uniqueness, order enforcement).
- No repetitions between sections.
- Title and Style of Music Check:
- Correct placement below the output.
- Accurate description without unnecessary details.
- Section Formatting Check:
- Proper attribute order and consistent spacing.
- No missing attributes.
- Duration Validation:
- Minimum of 8 bars and increments of 8.
- Character Limit Compliance:
- Ensure the output remains under 3000 characters.
- Correct Instructions Formatting:
- Transition phrase: “This section is followed by Section X.”
- Final Output Review:
- No empty fields displayed in the final JSS output.
7. JSS Example Output
[Intro (tempo: 120 BPM, instruments: piano, strings, duration: 16 bars, vocal style: soft, vocal emotion: hopeful, vocal effect: reverb, instructions: This section is followed by Verse.)]
The dawn breaks over silent hills.
[Verse (instruments: acoustic guitar, drums, duration: 16 bars, vocal style: whispery male voice, vocal emotion: melancholic, vocal effect: subtle echo, instructions: This section is followed by Chorus.)]
Wandering shadows, lost in time.
Title: Shadows of Yesterday
Style of Music: Reflective, cinematic orchestration with introspective lyrics.
Character Count: 271
These specifications ensure that JSS outputs are structured, optimized, and ready for seamless integration with Suno’s AI music generation platform.