Connect your device via USB and click the button below to install.
## SendspinZero NO Display for Analog + Digital Coax and Toslink versions WITHOUT display. Edit the settings below.
substitutions:
name: sendspin-headphones
friendly_name: Sendspin-Headphones
## SETTINGS ######################################################################################################################################
# Startup sound, options are: Home_Connected or Home_Connected_Male
startup_sound_file: Home_Connected
media_sample_rate: 48000
## END OF SETTINGS ###############################################################################################################################
esphome:
name: ${name}
friendly_name: ${friendly_name}
min_version: 2026.7.4
name_add_mac_suffix: true
project:
name: realdeco.sendspin_zero
version: "2026.7.4"
on_boot:
priority: -100
then:
- script.execute: led_red
esp32:
variant: esp32s3
framework:
type: esp-idf
logger:
level: warn
api:
on_client_connected:
- lambda: |-
if (!id(boot_sound_played)) {
id(boot_sound_played) = true;
if (id(startup_sound_switch).state) {
id(play_sound)->execute(true, std::string("ready_sound"));
}
}
ota:
- platform: esphome
id: ota_esphome
wifi:
output_power: 8.5dB
ap:
improv_serial:
captive_portal:
psram:
mode: quad
speed: 80MHz
deep_sleep:
id: deep_sleep_control
wakeup_pin:
number: GPIO4
mode: INPUT_PULLUP
inverted: true
allow_other_uses: true
wakeup_pin_mode: INVERT_WAKEUP
binary_sensor:
- platform: gpio
pin:
number: GPIO4
mode: INPUT_PULLUP
allow_other_uses: true
id: sleep_button
name: "Sleep Button"
filters:
- delayed_on: 50ms
- delayed_off: 200ms
on_press:
then:
- lambda: id(long_press_triggered) = false;
- script.execute: long_press_sleep_timer
on_release:
then:
- if:
condition:
lambda: return id(long_press_triggered);
then:
- logger.log: "Long press released - entering deep sleep..."
- lambda: id(long_press_triggered) = false;
- delay: 300ms
- deep_sleep.enter:
id: deep_sleep_control
else:
- script.stop: long_press_sleep_timer
- if:
condition:
lambda: return id(single_click_pending);
then:
- lambda: id(single_click_pending) = false;
- script.stop: single_click_timer
- logger.log: "Double touch"
# put your double-click action here
- media_player.next:
id: sendspin_group_media_player
else:
- lambda: id(single_click_pending) = true;
- script.execute: single_click_timer
sendspin:
id: sendspin_hub
i2s_audio:
- id: i2s_audio_bus
i2s_lrclk_pin: GPIO5
i2s_bclk_pin: GPIO7
speaker:
- platform: i2s_audio
id: box_speaker
i2s_audio_id: i2s_audio_bus
i2s_dout_pin: GPIO6
dac_type: external
channel: stereo
- platform: mixer
id: mixing_speaker
output_speaker: box_speaker
num_channels: 2
source_speakers:
- id: announcement_mixing_input
- id: media_mixing_input
- platform: resampler
id: announcement_resampling_speaker
output_speaker: announcement_mixing_input
sample_rate: ${media_sample_rate}
bits_per_sample: 16
- platform: resampler
id: media_resampling_speaker
output_speaker: media_mixing_input
sample_rate: ${media_sample_rate}
bits_per_sample: 16
audio_file:
- id: ready_sound
file: https://github.com/RealDeco/xiaozhi-esphome/raw/main/sounds/${startup_sound_file}.flac
media_source:
- platform: audio_file
id: audio_file_announcement_source
- platform: audio_http
id: http_announcement_source
- platform: audio_http
id: http_media_source
- platform: sendspin
id: sendspin_media_source
media_player:
- platform: sendspin
id: sendspin_group_media_player
name: Sendspin Group Media Player
- platform: speaker_source
id: external_media_player
name: Media Player
announcement_pipeline:
format: FLAC
num_channels: 1
sample_rate: ${media_sample_rate}
speaker: announcement_resampling_speaker
sources:
- audio_file_announcement_source
- http_announcement_source
media_pipeline:
format: FLAC
num_channels: 2
sample_rate: ${media_sample_rate}
speaker: media_resampling_speaker
sources:
- http_media_source
- sendspin_media_source
volume_increment: 0.05
volume_min: 0.4
volume_max: 0.9
on_state:
then:
- lambda: |-
using media_player::MediaPlayerState;
auto state = id(external_media_player).state;
if (
state == MediaPlayerState::MEDIA_PLAYER_STATE_PLAYING ||
state == MediaPlayerState::MEDIA_PLAYER_STATE_ANNOUNCING
) {
id(led_green).execute();
} else {
id(led_red).execute();
}
script:
- id: single_click_timer
mode: restart
then:
- delay: 600ms
- if:
condition:
lambda: return id(single_click_pending);
then:
- lambda: id(single_click_pending) = false;
- logger.log: "Single touch - toggle"
- media_player.toggle:
id: sendspin_group_media_player
- id: long_press_sleep_timer
mode: restart
then:
- delay: 3s
- if:
condition:
binary_sensor.is_on: sleep_button
then:
- lambda: id(long_press_triggered) = true;
- logger.log: "Long press detected"
- media_player.stop:
id: external_media_player
- light.turn_off:
id: led
- id: play_sound
parameters:
priority: bool
sound_file: string
then:
- if:
condition:
lambda: return priority;
then:
- media_player.stop:
id: external_media_player
announcement: true
- lambda: |-
if ((id(external_media_player).state != media_player::MediaPlayerState::MEDIA_PLAYER_STATE_ANNOUNCING) || priority) {
id(external_media_player)
->make_call()
.set_media_url("audio-file://" + sound_file)
.set_announcement(true)
.perform();
}
- id: led_red
then:
- light.turn_on:
id: led
red: 100%
green: 0%
blue: 0%
brightness: 100%
- id: led_green
then:
- light.turn_on:
id: led
red: 0%
green: 100%
blue: 0%
brightness: 100%
switch:
- platform: template
id: startup_sound_switch
name: Startup sound
icon: "mdi:card-text-outline"
entity_category: config
optimistic: true
restore_mode: RESTORE_DEFAULT_ON
button:
- platform: restart
id: restart_button
name: "Restart"
entity_category: config
icon: "mdi:restart"
text_sensor:
- platform: sendspin
id: sendspin_title
name: "Song Title"
type: title
- platform: sendspin
id: sendspin_artist
name: "Song Artist"
type: artist
- platform: sendspin
id: sendspin_album
name: "Album Name"
type: album
globals:
- id: single_click_pending
type: bool
restore_value: no
initial_value: "false"
- id: long_press_triggered
type: bool
restore_value: no
initial_value: "false"
- id: boot_sound_played
type: bool
restore_value: no
initial_value: "false"
- id: boot_announce_active
type: bool
restore_value: no
initial_value: "false"
light:
- platform: esp32_rmt_led_strip
id: led
name: LED light
disabled_by_default: false
entity_category: config
pin: GPIO48
default_transition_length: 0s
chipset: WS2812
num_leds: 1
rgb_order: grb
effects:
- pulse:
name: "Slow Pulse"
transition_length: 250ms
update_interval: 250ms
min_brightness: 50%
max_brightness: 100%
- pulse:
name: "Fast Pulse"
transition_length: 100ms
update_interval: 100ms
min_brightness: 50%
max_brightness: 100%
# Factory firmware - generated by ewt-gen
# Users should import Sendspin_Supermini-Headphones.yaml directly, not this file.
packages:
original: !include Sendspin_Supermini-Headphones.yaml
esphome:
project:
version: "2026.08.08.42"
ota:
- platform: http_request
id: ota_http_request
update:
- platform: http_request
id: update_http_request
name: Firmware
source: https://realdeco.github.io/SendspinZero/Sendspin_Supermini-Headphones/manifest.json
http_request:
dashboard_import:
package_import_url: github://RealDeco/SendspinZero/Sendspin_Supermini-Headphones.yaml@main