Skip to content

Latest commit

 

History

History
333 lines (284 loc) · 16.3 KB

naming.md

File metadata and controls

333 lines (284 loc) · 16.3 KB
Raw

Comprehensive IRDB (Infrared Database) Naming Standards

1. Button Name Standardization

Universal Remote Standard (Primary)

TVs Audio ACs Fans LEDs Monitors Digital Signs
Power Power Off Power Power Power Power
Vol_up Vol_up Cool_hi Speed_up Bright+ Source Source
Vol_dn Vol_dn Cool_lo Speed_dn Bright- Menu Play
Ch_next Next Heat_hi Mode Flash Exit Stop
Ch_prev Prev Heat_lo Rotate
Mute Mute Dh Timer
Play
Pause

XRemote Additional Standard Buttons

Navigation Functions Media Other
Up Eject Fast_fo Menu
Down Setup Fast_ba List
Left Input Play_pa Info
Right Back Stop Mode
Ok

Jay's Extended Button Names

TVs Audio ACs Fans LEDs Monitors Digital Signs DVD/Blu-ray Gaming Streaming
Smart Bass Swing Nat Color PIP Sched Eject A Home
EPG Treble Fan Night Tone Freeze Layout Top_menu B Search
PIP EQ Eco Humid FX ECO Update Angle X Voice
Fav Repeat Turbo Ion Sync Aspect Zoom Subtitle Y Netflix
CC Shuffle Quiet Preset Split Lock Audio L1 Prime
Aspect Amp Sleep Dimmer Auto Rotate Zoom R1 Disney
Proglist Next Options Hulu
Red Prev Share
Green Capture
Yellow
Blue

Button Renaming

TV Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
On turn_on, power_on, start
Off turn_off, power_off, shutdown
Vol_up volume_up, vol+, louder, audio_up
Vol_dn volume_down, vol-, quieter, audio_down
Ch_next channel_up, ch+, prog+, tune_up
Ch_prev channel_down, ch-, prog-, tune_down
Mute mute_toggle, silent, audio_mute
Source input, tv/av, mode, signal
Menu home, smart_hub, settings
Exit close, esc
Back return, prev
Up arrow_up, navigate_up
Down arrow_down, navigate_down
Left arrow_left, navigate_left
Right arrow_right, navigate_right
Ok enter, select, confirm
Play_pa play_pause, play/pause
Fast_fo fast_forward, ffwd, ff
Fast_ba fast_backward, rewind, rew
Subc subchannel, dash, dot
Proglist program_list, channel_list
Picture pic_mode, image_preset
Sound snd_mode, audio_preset
Smart smart_hub, home
EPG guide, tv_guide, program_guide

Audio Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
On turn_on, power_on, start
Off turn_off, power_off, shutdown
Vol_up volume_up, vol+, louder, audio_up
Vol_dn volume_down, vol-, quieter, audio_down
Next track_next, skip_forward
Prev track_prev, skip_backward
Play start_playback, resume
Pause pause_playback, break
Stop end_playback, halt
Mute mute_toggle, silent, audio_mute
Source input, mode, function
Bass bass_adjust, low_freq
Treble treble_adjust, high_freq
EQ equalizer, sound_mode, audio_preset
Repeat repeat_mode, loop
Shuffle random, mix
Amp amplifier, receiver

AC Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
On turn_on, power_on, start
Off turn_off, power_off, shutdown
Cool_hi cool_high, max_cool, cooling_high
Cool_lo cool_low, eco_cool, cooling_low
Heat_hi heat_high, max_heat, heating_high
Heat_lo heat_low, eco_heat, heating_low
Dh dehumidify, dry_mode, moisture_remove
Fan fan_speed, air_flow, ventilate
Swing air_direction, louver, vane, osc, oscillate
Turbo jet, powerful, boost
Quiet silent, whisper, low_noise
Sleep night_mode, eco_night, timer
Eco energy_save, power_save
Ion ionizer, air_clean, purify

Fan Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
On turn_on, power_on, start
Off turn_off, power_off, shutdown
Speed_up faster, increase_speed, wind_up
Speed_dn slower, decrease_speed, wind_down
Mode function, air_flow, fan_mode
Rotate oscillate, swing, scan
Timer auto_off, schedule, delay_off
Nat natural_wind, breeze, simulate
Humid humidify, mist, vapor
Night sleep_mode, quiet_mode
Ion ionizer, air_clean, purify

LED Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
On turn_on, power_on, start
Off turn_off, power_off, shutdown
Bright+ brightness_up, brighter, intensify
Bright- brightness_down, dimmer, soften
Color color_change, hue, tint
Tone temperature, warmth, kelvin
FX effect, animate, dynamic
Sync music_mode, rhythm, sound_active
Preset scene, mode, theme
Flash strobe, blink, pulse
Dimmer dim_mode, night_light

Monitor Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
On turn_on, power_on, start
Off turn_off, power_off, shutdown
Source input, input_select, mode
Menu osd, on_screen_display, settings
Exit close, esc
PIP picture_in_picture, multi_view
Freeze still, pause_screen, hold
ECO energy_save, power_save, efficiency
Aspect ratio, screen_fit, zoom
Split screen_split, dual_view, multi_screen
Auto auto_adjust, auto_config

Digital Signs Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
On turn_on, power_on, start
Off turn_off, power_off, shutdown
Source input, input_select, mode
Play start_content, run, begin
Stop end_content, halt, terminate
Sched schedule, timer, program
Layout display_mode, screen_layout, format
Update refresh, sync_content, reload
Zoom scale, resize, magnify
Lock keypad_lock, child_lock, security
Rotate rotate_screen, orientation

DVD/Blu-ray Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
Eject open_close, disc
Play start_playback, resume
Pause pause_playback, break
Stop end_playback, halt
Fast_fo fast_forward, ffwd, ff
Fast_ba fast_backward, rewind, rew
Next skip_forward, track_next
Prev skip_backward, track_prev
Menu disc_menu, root_menu
Top_menu title_menu, main_menu
Setup settings, config
Audio sound_track, language
Subtitle captions, subs
Angle camera_angle, view
Zoom magnify, enlarge

Gaming Console Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
Up arrow_up, navigate_up
Down arrow_down, navigate_down
Left arrow_left, navigate_left
Right arrow_right, navigate_right
Start begin, launch
Select options, menu
Home dashboard, main_menu
A cross, green
B circle, red
X square, blue
Y triangle, yellow
L1 lb, left_bumper
R1 rb, right_bumper
L2 lt, left_trigger
R2 rt, right_trigger
Share capture, record
Touchpad touch, pad

Streaming Device Buttons

Standard Name Acceptable Alternatives
Power pwr, powr, on_off, switch, toggle
Home main_menu, dashboard
Back return, prev
Play start_playback, resume
Pause pause_playback, break
Play_pa play_pause, play/pause
Stop end_playback, halt
Fast_fo fast_forward, ffwd, ff
Fast_ba fast_backward, rewind, rew
Up arrow_up, navigate_up
Down arrow_down, navigate_down
Left arrow_left, navigate_left
Right arrow_right, navigate_right
Ok enter, select, confirm
Search find, lookup
Voice mic, voice_command
Netflix netflix_shortcut
Prime amazon, prime_video
Hulu hulu_shortcut
Disney disney_plus, disney+
Youtube yt, youtube_shortcut
Appstore app_store, apps

2. File Naming Convention

Format Example
Brand_Model.ir Samsung_UN55NU7100.ir
Sony_TV_DVDCB.ir
UnknownBrand_32inchLEDTV.ir
Universal_TV_Remote_Model123.ir

Guidelines:

  • Use underscore (_) to separate words
  • Include brand name first, followed by model
  • For unknown brands or models, use descriptive names
  • Omit device type from filename (include in metadata)

3. Metadata and Commenting

Comment Format

All metadata should be placed at the beginning of the file, with each piece of information on a new comment line, following this format:

#
# Brand: [Brand]
# Device Model: [Device Model]
# Remote Model: [Remote Model]
# Device Type: [Device Type]
# Protocol: [Protocol]
# Link: [URL]
# Description: [Brief description]
# Contributor: [Your Name]
#
  • Ensure there is an empty comment line (#) before and after the metadata section for clarity.

4. General Guidelines

  • Consistency: Always adhere to the naming conventions and standards outlined in this document to maintain consistency across the database.

  • Case Sensitivity: Button names and metadata fields should be in the exact case as specified (e.g., Vol_up, Brand).

  • Special Characters: Avoid using special characters or spaces in filenames and button names. Use underscores (_) to separate words.

  • Unknown Information: If certain metadata fields are unknown, they can be omitted except for the required fields.

  • Comment Lines: Use # at the beginning of a line to denote a comment in the .ir file.

5. Submission Process

When contributing to the IRDB:

  1. Format Files: Ensure your .ir files are formatted according to the standards in this document.

  2. Verify Data: Double-check all metadata and button names for accuracy.

6. Example IR File Structure

An example of a properly formatted .ir file:

Filetype: IR signals file
Version: 1
#
# Brand: Viano
# Remote Model: STV65UHD4K
# Device Type: TV
#
name: Power
type: parsed
protocol: NECext
address: 00 7F 00 00
command: 1E E1 00 00
#