Pixel FX Shop
Home / Support / Docs / FX-Framework Custom IR Remote Guide
FX-Framework

FX-Framework Custom IR Remote Guide

Requires Morph 4K or Morph 2K

The Morph can be controlled with a different IR remote than the one it ships with, as long as the remote uses the NEC IR protocol (used by many remotes, and by most universal remotes for at least some device codes).

Which button triggers which function is stored in an ir.ini file, which can be uploaded via the web interface:

  • Refer to PFX-WebUI for how to connect to the web interface.

  • The Custom IR Remote (ir.ini) card is on the Customize page of the web interface.

Finding the codes of your remote#

  • Press Start IR debug on the Custom IR Remote (ir.ini) card and wait until the badge next to IR Debug shows Connected.

  • Point the remote at the Morph and press a button. The window shows the Address and the Command of that button.

  • Write down the Command of every button you want to use. The Address is usually the same for all buttons of a remote.

If nothing shows up, the remote does not use the NEC protocol and cannot be used with the Morph. On a universal remote, try a device code of a different brand.

Format#

The mapping is stored in an .ini file, which has the following format:

address = ADDRESS
FUNCTION = COMMAND
  • ADDRESS and COMMAND are the values shown by IR debug, including the 0x prefix (e.g. 0xfe01).

  • An address line applies to all FUNCTION lines below it, up to the next address line. This way one ir.ini can hold the buttons of several remotes (see Example 3).

  • Lines starting with ; or # are comments.

Functions (FUNCTION)#

  • command_menu Open the OSD (inside the OSD: back)

  • command_ok Select / confirm inside the OSD (with the OSD closed: open the OSD)

  • command_cancel Back / close the OSD

  • command_up / command_down / command_left / command_right Navigate the OSD. With the OSD closed, these open the quick menus:

    • Morph 4K: up: input, down: output resolution, right: presets
    • Morph 2K: up: presets, down: output resolution, left: input, right: scaler
  • command_minus / command_plus Change the selected value in steps of 10 (on OSD pages where values are changed with left / right). In the main menu, command_minus opens the reset menu.

  • command_setup / command_app Extra function keys, used by some OSD pages

  • command_set Open the presets (with the OSD closed) (Morph 2K only)

  • command_res_reset Reset the selected value to its default (on OSD pages that support it). Hold the button for about 5 seconds to reset the output resolution to the default, e.g. when the display does not show a picture.

  • command_power Power the Morph down / up

  • command_mute Mute / unmute the HDMI audio

  • command_a_volume_up / command_a_volume_down Audio volume up / down (if the audio hardware of the Morph supports it)

  • command_num_0 ... command_num_9 Trigger what is assigned to that number, e.g. a preset (OSD: select a preset in Presets, then Map preset to remote). The assignments are stored in /sdcard/conf/remote.ini.

  • command_capture Save a screenshot of the picture to the SD card, press again to cancel (Morph 4K only) (requires fw >= 4.0.79)

  • command_capture_input Save an input capture (the source frame as received, before scaling) to the SD card (Morph 4K only, engines with input capture, e.g. Universal Adaptive) (requires fw >= 4.0.79)

  • command_auto_zoom Zoom the picture inside the frame to the full screen height, until the source changes (Morph 4K only) (requires fw >= 4.0.84)

  • command_ovrscn_c Turn the overscan border color on / off

Important#

  • An uploaded ir.ini replaces the built-in one. Buttons that are not in your file do nothing, including the buttons of the remote that ships with the Morph. To keep using that remote, keep its lines in your file (see Example 3).

  • A new ir.ini is used right after the upload, no restart needed. Delete on the card removes it, and the built-in setup is used again.

  • Download ir.ini on the card downloads your uploaded file, or an example if none was uploaded.

Example 1 (default setup)#

The built-in setup for the remote that ships with the Morph:

; # Standard remote
address = 0xfe01
command_menu = 0xee11
command_ok = 0xec13
command_cancel = 0xe619
command_capture = 0xb34c
command_capture_input = 0xa758
command_auto_zoom = 0xff00
command_up = 0xe916
command_down = 0xe51a
command_left = 0xae51
command_right = 0xaf50
command_minus = 0xef10
command_plus = 0xe718
command_setup = 0xbc43
command_app = 0xf00f
command_res_reset = 0xbd42
command_power = 0xbf40
command_a_volume_up = 0x0af5
command_a_volume_down = 0x0bf4
command_mute = 0xbe41
command_set = 0x0df2
; numeric buttons
command_num_0 = 0xfe01
command_num_1 = 0xb14e
command_num_2 = 0xf20d
command_num_3 = 0xf30c
command_num_4 = 0xb54a
command_num_5 = 0xf609
command_num_6 = 0xf708
command_num_7 = 0xb946
command_num_8 = 0xfa05
command_num_9 = 0xfb04

Example 2 (OSSC remote)#

Only the OSSC remote, the remote that ships with the Morph no longer works:

; # OSSC
address = 0x837c
command_menu = 0x4db2
command_ok = 0x47b8
command_cancel = 0x48b7
command_up = 0x4bb4
command_down = 0x4cb3
command_left = 0x4ab5
command_right = 0x49b6

Example 3 (standard remote + Framemeister remote)#

Both remotes work: add these lines at the end of Example 1:

; # Framemeister
address = 0xff00
command_menu = 0xab54
command_ok = 0xfc03
command_cancel = 0xac53
command_up = 0xf30c
command_down = 0xef10
command_left = 0xf708
command_right = 0xfb04

Tip#

  • Always start the file with an address line.

  • Each button can only trigger one function. If the same address / COMMAND pair is listed twice, the first line is used.

  • To disable a button, remove its line or turn it into a comment:

    ; command_power = 0xbf40
    

Documentation - Index