Skip to content

Azahar

Azahar Table of Contents

Getting Started with Azahar

How to Install Azahar

Back to the Top

The Basics

$HOME or ~ refer to your home directory. On a typical linux distro, the full path will be \$HOME/\$USER. On a Steam Deck, the full path will be /home/deck. When navigating using the file manager, the file manager may not be display the username visually in the full file path.

Directories with a . in front of their name, like $HOME/.steam, are hidden by default. In Dolphin (a file manager), click the hamburger menu in the top right and toggle on Show Hidden Files. The setting may vary depending on which file manager you are using.

$HOME/Applications refers to the Applications folder in your home directory. On a typical linux distro, the full path will be \$HOME/\$USER/Applications. On a Steam Deck, the full path will be /home/deck/Applications. When navigating using the file manager, the file manager may not display the username visually in the full file path. The Applications folder is not created by default. If you have not created one already, do so before following the steps in this section.

Azahar is available both as an AppImage and a Flatpak on Linux. This page will cover how to utilize and install the Flatpak.

To download Azahar:

  1. Open your distro's software manager.
    • On SteamOS and distros with KDE, you may use Discover, a "store" to install and manage Flatpaks.
  2. Search for "Azahar" and click "Install" on the top right of the software page For Azahar
  3. Open Konsole or a terminal of your choice
  4. Type the following two lines, one at a time, and press enter after each line:
    • flatpak override org.azahar_emu.Azahar --filesystem=host --user
    • Alternatively, you may install and use Flatseal from your distro's software manager. Open Flatseal, locate the emulator on the left-hand side of the screen, scroll down to the Filesystem section and enable All system files

Azahar Tips and Tricks

Back to the Top

How to Manage DLC and Updates

Back to the Top

Read: https://3ds.hacks.guide/dumping-titles-and-game-cartridges.html to learn how to properly dump your DLC and update files from your 3DS.

DLC and update files typically are .CIAs, an installable file format through Azahar. After installing your DLC or updates, you may discard these files.

How to Install DLC and Updates

  1. In Desktop Mode, open azahar
  2. Click File in the top left
  3. Click Install CIA...
  4. Navigate to your DLC or update files

Note

How to Configure Gyro With External Controllers

Back to the Top

Desktop Mode

  1. Switch to Desktop Mode
  2. Exit out of Steam
    • You may exit out of Steam a couple of different ways:
      * Right click the `Steam` icon in your taskbar and click `Exit Steam`
* Open Steam, click the `Steam` button in the top left, click `Exit`
* Open a terminal (Konsole) and enter `killall -9 steam`
* Do note that clicking the the `X` button in the top right of the Steam window **will not** exit out of Steam
    • Your controls will switch to Lizard Mode. Use L2 to right click, R2 to left click, and the Right Trackpad to move the mouse
    • You may also connect an external keyboard and mouse
  3. Click the bluetooth icon in the bottom right of your taskbar and connect your controller
  4. Open azahar
  5. Click Emulation at the top, click Configure
  6. Click Controls on the left
  7. Click New to the right of Profile and give it a unique name
  8. Click Motion / Touch.. in the bottom left
  9. To the right of Motion Provider, select SDL in the drop-down menu
  10. Click Configure and follow the instructions
  11. Click OK
  12. Click OK again and exit out of azahar
  13. Switch to Game Mode

Game Mode

  1. In Game Mode, connect your controller
  2. Select your Nintendo 3DS game
  3. On the Play screen, select the Controller icon to the right of the screen
  4. Select your controller tab at the top
  5. Click the Gear icon to the right, and click Disable Steam Input
    • You may need to restart first for this setting to properly apply
  6. Your controller's gyro will now work for this selected game, repeat as needed for your other games

Post-Configuration

To restore the default Steam Deck controls:

  1. Open Azahar
  2. Click Emulation at the top, click Configure
  3. Click Controls on the left
  4. To the right of Profile, select SD-Default in the drop-down menu
  5. Click OK and exit out of azahar

(Optional) To restore Steam Input:

  1. Select your Nintendo 3DS game
  2. On the Play screen, select the Controller icon to the right of the screen
  3. Select your controller tab at the top
  4. Click the Gear icon to the right, and click Enable Steam Input
    • You may need to restart first for this setting to properly apply
  5. The controls will be reverted to Steam Input and the Steam Deck controls will be restored

How to Install Custom Textures

Back to the Top

Here's how to install custom textures for azahar:

azahar Configuration

  1. In Desktop Mode, open Azahar
  2. Click Emulation in the top left. Click Configuration, Graphics, and check both Use Custom Textures and Async Custom Texture Loading

Note: Preload Custom Textures is no longer recommended. Leave Preload Custom Textures off

How to Install Custom Textures

Note: Your texture pack may already come properly named and packaged with the correct TitleID and texture files. You may place the included texture pack folder directly into /home/deck/.local/share/azahar-emu/textures/. You do not need the following section if this is the case.

  1. In Desktop Mode, open https://3ds.jdbye.com/?details=USA&split=0&display=0 in a browser
  2. Note down the Title ID for the game
    • For example, The Legend of Zelda: Majora's Mask 3D's (US) Title ID is: 0004000000125500
  3. Open $HOME/.var/org.azahar_emu.Azahar/textures/
  4. In the textures folder from Step 3, create a folder matching the TitleID from Step 2
  5. Put your texture files directly into the TitleID folder you created in Step 4
  6. Your texture pack should now be installed

Tip

Consider enabling Preload Custom Textures. This may help performance in some cases.

How to Use Cheats

Back to the Top

Cheat Sources

This list is not exhaustive

How to Use Cheats

  1. In Desktop Mode, open Azahar
  2. Right click a game of your choice, click Properties
  3. Click the Cheats tab
  4. Click Add Cheat
  5. Name the cheat and add the code to the box under Code:
  6. Click Save in the top right
  7. Check the box to the left of the cheat to enable it

How to Configure Language Settings

Back to the Top

UI

  1. In Desktop Mode, open azahar
  2. At the top, click Emulation, click Configure
  3. On the left hand-side of the screen, click General
  4. Click the UI tab
  5. Under General, select your preferred language in the drop-down menu

In-Game

  1. In Desktop Mode, open azahar
  2. At the top, click Emulation, click Configure
  3. On the left hand-side of the screen, click System
  4. Click the System tab
  5. Under System Settings, select your preferred language in the drop-down menu

Custom Screen Layouts

Back to the Top

How to Create Custom Screen Layouts

Back to the Top

Use https://jesuscc1993.github.io/miscellaneous/azahar-layout-generator/ to create custom layouts.

After you have created your custom layout, use the following steps to use it.

  1. Open the folder:
    • $HOME/.var/org.azahar_emu.Azahar
  2. Right click qt-config.ini, and click Open with Kate or a text editor of your choice
  3. Locate the [Layout] section
  4. Replace the content of the [Layout] section with your newly created layout

How to Configure Bottom Screen as PiP

Back to the Top

Credit: NexLevel

azahar allows you to configure the bottom screen as a sort of PiP (Picture in Picture) overlay on the top screen, by editing the qt-config file.

Here's How

  1. Open the folder:
    • $HOME/.var/org.azahar_emu.Azahar
  2. Right click qt-config.ini, and click Open with Kate or a text editor of your choice
  3. Locate the [Layout] section

  4. Replace the content of the [Layout] section with the below text:

      [Layout]
  anaglyph_shader_name=dubois (builtin)
  anaglyph_shader_name\default=true
  custom_bottom_bottom=800
  custom_bottom_bottom\default=false
  custom_bottom_left=520
  custom_bottom_left\default=false
  custom_bottom_right=760
  custom_bottom_right\default=false
  custom_bottom_top=620
  custom_bottom_top\default=false
  custom_layout=true
  custom_layout\default=false
  custom_second_layer_opacity=33
  custom_second_layer_opacity\default=false
  custom_top_bottom=784
  custom_top_bottom\default=false
  custom_top_left=0
  custom_top_left\default=true
  custom_top_right=1280
  custom_top_right\default=false
  custom_top_top=16
  custom_top_top\default=false
  factor_3d=0
  factor_3d\default=true
  filter_mode=true
  filter_mode\default=true
  large_screen_proportion=@Variant(\0\0\0\x87@\x80\0\0)
  large_screen_proportion\default=false
  layout_option=1
  layout_option\default=false
  mono_render_option=0
  mono_render_option\default=true
  pp_shader_name=none (builtin)
  pp_shader_name\default=true
  render_3d=0
  render_3d\default=true
  swap_screen=false
  swap_screen\default=true
  upright_screen=false
  upright_screen\default=true

  5. (Optional) To move the PiP screen up, try setting custom_top_top=0 and custom_top_bottom=768

  6. Save and exit out of the text file, azahar will now be using the bottom screen as PiP

Note: To revert back to defaults, the default [Layout] section is: 

[Layout]
anaglyph_shader_name=dubois (builtin)
anaglyph_shader_name\default=true
custom_bottom_bottom=480
custom_bottom_bottom\default=true
custom_bottom_left=40
custom_bottom_left\default=true
custom_bottom_right=360
custom_bottom_right\default=true
custom_bottom_top=240
custom_bottom_top\default=true
custom_layout=false
custom_layout\default=true
custom_second_layer_opacity=100
custom_second_layer_opacity\default=true
custom_top_bottom=240
custom_top_bottom\default=true
custom_top_left=0
custom_top_left\default=true
custom_top_right=400
custom_top_right\default=true
custom_top_top=0
custom_top_top\default=true
factor_3d=0
factor_3d\default=true
filter_mode=true
filter_mode\default=true
large_screen_proportion=@Variant(\0\0\0\x87@\x80\0\0)
large_screen_proportion\default=true
layout_option=2
layout_option\default=false
mono_render_option=0
mono_render_option\default=true
pp_shader_name=none (builtin)
pp_shader_name\default=true
render_3d=0
render_3d\default=true
swap_screen=false
swap_screen\default=true
upright_screen=false
upright_screen\default=true

How to Configure Bottom Screen With PiP and Opacity

Back to the Top

Credit: NexLevel

A recent update of azahar allows the ability to set the opacity on the bottom screen. In combination with setting the bottom screen as a PiP overlay, you can create a azahar layout that looks like the following:

Example 1:

Example 2:

Here's How

  1. Open the folder: /home/deck/.config/azahar-emu/
    • ~/.config is a hidden folder by default. In Dolphin (file manager), click the hamburger menu in the top right, click Show Hidden Files to see these folders
  2. Right click qt-config.ini, and click Open with Kate or a text editor of your choice
  3. Locate the [Layout] section

  4. Replace the content of the [Layout] section with the below text:

      [Layout]
  anaglyph_shader_name=dubois (builtin)
  anaglyph_shader_name\default=true
  custom_bottom_bottom=800
  custom_bottom_bottom\default=false
  custom_bottom_left=520
  custom_bottom_left\default=false
  custom_bottom_right=760
  custom_bottom_right\default=false
  custom_bottom_top=620
  custom_bottom_top\default=false
  custom_layout=true
  custom_layout\default=false
  custom_second_layer_opacity=33
  custom_second_layer_opacity\default=false
  custom_top_bottom=784
  custom_top_bottom\default=false
  custom_top_left=0
  custom_top_left\default=true
  custom_top_right=1280
  custom_top_right\default=false
  custom_top_top=16
  custom_top_top\default=false
  factor_3d=0
  factor_3d\default=true
  filter_mode=true
  filter_mode\default=true
  large_screen_proportion=@Variant(\0\0\0\x87@\x80\0\0)
  large_screen_proportion\default=false
  layout_option=1
  layout_option\default=false
  mono_render_option=0
  mono_render_option\default=true
  pp_shader_name=none (builtin)
  pp_shader_name\default=true
  render_3d=0
  render_3d\default=true
  swap_screen=false
  swap_screen\default=true
  upright_screen=false
  upright_screen\default=true

  5. To adjust the PiP opacity, the opacity can be any integer between 1-100

  6. Save and exit out of the text file, azahar will now be using the bottom screen as PiP with custom opacity

Note: To revert back to defaults, the default [Layout] section is: 

[Layout]
anaglyph_shader_name=dubois (builtin)
anaglyph_shader_name\default=true
custom_bottom_bottom=480
custom_bottom_bottom\default=true
custom_bottom_left=40
custom_bottom_left\default=true
custom_bottom_right=360
custom_bottom_right\default=true
custom_bottom_top=240
custom_bottom_top\default=true
custom_layout=false
custom_layout\default=true
custom_second_layer_opacity=100
custom_second_layer_opacity\default=true
custom_top_bottom=240
custom_top_bottom\default=true
custom_top_left=0
custom_top_left\default=true
custom_top_right=400
custom_top_right\default=true
custom_top_top=0
custom_top_top\default=true
factor_3d=0
factor_3d\default=true
filter_mode=true
filter_mode\default=true
large_screen_proportion=@Variant(\0\0\0\x87@\x80\0\0)
large_screen_proportion\default=true
layout_option=2
layout_option\default=false
mono_render_option=0
mono_render_option\default=true
pp_shader_name=none (builtin)
pp_shader_name\default=true
render_3d=0
render_3d\default=true
swap_screen=false
swap_screen\default=true
upright_screen=false
upright_screen\default=true

How to Configure Bottom Screen as PiP in the Top Right Corner

Back to the Top

Picture:

How to Configure Bottom Screen as PiP in the Top Right Corner

Credit: busywait

  1. Open the folder: /home/deck/.config/azahar-emu/
    • ~/.config is a hidden folder by default. In Dolphin (file manager), click the hamburger menu in the top right, click Show Hidden Files to see these folders
  2. Right click qt-config.ini, and click Open with Kate or a text editor of your choice
  3. Locate the [Layout] section

  4. Replace the content of the [Layout] section with the below text:

      [Layout]
  anaglyph_shader_name=dubois (builtin)
  anaglyph_shader_name\default=true
  custom_bottom_bottom=240
  custom_bottom_bottom\default=false
  custom_bottom_left=960
  custom_bottom_left\default=false
  custom_bottom_right=1280
  custom_bottom_right\default=false
  custom_bottom_top=0
  custom_bottom_top\default=false
  custom_layout=true
  custom_layout\default=false
  custom_second_layer_opacity=80
  custom_second_layer_opacity\default=false
  custom_top_bottom=800
  custom_top_bottom\default=false
  custom_top_left=0
  custom_top_left\default=true
  custom_top_right=1200
  custom_top_right\default=false
  custom_top_top=80
  custom_top_top\default=false
  factor_3d=0
  factor_3d\default=true
  filter_mode=true
  filter_mode\default=true
  large_screen_proportion=4
  large_screen_proportion\default=true
  layout_option=1
  layout_option\default=false
  mono_render_option=0
  mono_render_option\default=true
  pp_shader_name=none (builtin)
  pp_shader_name\default=true
  render_3d=0
  render_3d\default=true
  swap_screen=false
  swap_screen\default=true
  upright_screen=false
  upright_screen\default=true

  5. Save and close out of the text file

  6. azahar will now apply your custom layout

Note: To revert back to defaults, the default [Layout] section is: 

[Layout]
anaglyph_shader_name=dubois (builtin)
anaglyph_shader_name\default=true
custom_bottom_bottom=480
custom_bottom_bottom\default=true
custom_bottom_left=40
custom_bottom_left\default=true
custom_bottom_right=360
custom_bottom_right\default=true
custom_bottom_top=240
custom_bottom_top\default=true
custom_layout=false
custom_layout\default=true
custom_second_layer_opacity=100
custom_second_layer_opacity\default=true
custom_top_bottom=240
custom_top_bottom\default=true
custom_top_left=0
custom_top_left\default=true
custom_top_right=400
custom_top_right\default=true
custom_top_top=0
custom_top_top\default=true
factor_3d=0
factor_3d\default=true
filter_mode=true
filter_mode\default=true
large_screen_proportion=@Variant(\0\0\0\x87@\x80\0\0)
large_screen_proportion\default=true
layout_option=2
layout_option\default=false
mono_render_option=0
mono_render_option\default=true
pp_shader_name=none (builtin)
pp_shader_name\default=true
render_3d=0
render_3d\default=true
swap_screen=false
swap_screen\default=true
upright_screen=false
upright_screen\default=true

Steam Deck

Back to the Top

How to Configure Gyro

Back to the Top

Gyro on the Steam Deck for Azahar requires SteamDeckGyroDSU.

Visit SteamDeckGyroDSU to learn how to install and utilize SteamDeckGyroDSU.