crispy-doom.cfg(5)

💖 crispy-doom.cfg — the manual, bestie edition 💖

okay so you opened crispy-doom.cfg(5) from the File Formats Manual and you're like "what is this" — don't worry, I got you. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

crispy-doom.cfg — the Crispy Doom configuration file, aka the lil extra settings file that makes your Doom yours 💅

---

🌸 DESCRIPTION 🌸

so crispy-doom.cfg is a configuration file for crispy-doom(6). it's an auxiliary config file, meaning it's the sidekick — the main config options live in default.cfg, which holds all the same options as Vanilla Doom (for compatibility reasons, periodt). crispy-doom.cfg is where the options that are specific to Crispy-Doom only live. it's giving ✨extra✨ and honestly? iconic.

normally this file chills in your home directory, at:

~/.local/share/crispy-doom/crispy-doom.cfg

but you can override that path with the XDG_DATA_HOME environment variable (check the XDG Base Directory Specification if you wanna know more, iykyk).

and if editing config files by hand is not your vibe (valid), the crispy-doom-setup(6) tool is a simple to use front-end for editing crispy-doom.cfg. slay. 💖

---

🎀 FILE FORMAT 🎀

the file format is the same as the one used for default.cfg(5). no new format, no surprises, we love consistency 🌈

---

👑 CONFIGURATION VARIABLES 👑

this is the main character section, bestie. every single one of these, right here:

• video_driver — name of the SDL video driver to use. if it's an empty string, you just get the default video driver. no thoughts, head empty, default behavior 💫
• window_position — where the window sits on your screen when you're running in windowed mode. accepted values are: "" (empty string) — don't care, "center" — place the window at the center of the screen, "x,y" — place the window at those exact coordinates. you're literally the main character choosing your own placement 💅
• fullscreen — if it's non-zero, the game runs in full screen mode. if it's zero, the game runs in a window. that's it, that's the whole vibe check.
• video_display — index of the display the game should run on. this does nothing if you're running in windowed mode (fullscreen=0) and window_position is not set to "center". so like, don't bother unless those conditions hit 🙈
• aspect_ratio_correct — if non-zero, the screen gets stretched vertically so it displays correctly on a square pixel video mode. your eyes will thank you.
• smooth_pixel_scaling — if non-zero, the screen gets smooth scaling. yes bestie, smooth ✨
• integer_scaling — if non-zero, this forces integer scales for resolution-independent rendering. whole numbers only, no crumbs.
• window_width — window width when running in windowed mode.
• window_height — window height when running in windowed mode.
• fullscreen_width — width for screen mode when running fullscreen. if this and fullscreen_height are both set to zero, we run fullscreen as a desktop window that covers the entire screen, rather than ever switching screen modes. and honestly? it should usually be unnecessary to set this value. so like, leave it alone, it's fine 🍓
• fullscreen_height — height for screen mode when running fullscreen. see the documentation for fullscreen_width, they're a matched set 🫶
• force_software_renderer — if non-zero, forces the use of a software renderer. this is for use on systems lacking hardware acceleration. we ride for the low-spec girlies 💀
• max_scaling_buffer_pixels — maximum number of pixels to use for the intermediate scaling buffer. more pixels means the screen can be rendered more precisely, but there are diminishing returns on quality (the way that more isn't always better…). the default limits to 16,000,000 pixels, which is enough to cover 4K monitor standards. ate.
• startup_delay — number of milliseconds to wait on startup after the video mode has been set, before the game will start. this lets the screen settle on some monitors that don't display an image for a brief interval after changing video modes. patience is a virtue, bestie 🌸
• show_endoom — if non-zero, the ENDOOM text screen is displayed when exiting the game. if zero, the ENDOOM screen is not displayed. choose wisely 😭
• show_diskicon — if non-zero, a disk activity indicator is displayed when data is read from disk. if zero, that indicator is not displayed. blink blink 💫
• png_screenshots — if non-zero, screenshots are saved in PNG format. if zero, screenshots are saved in PCX format, exactly as Vanilla Doom does. old school or new school, your call 📸
• mouse_acceleration_y — the vertical mouse acceleration factor. when the speed of mouse movement exceeds the threshold value (mouse_threshold), the speed gets multiplied by this value. zoom zoom 🖱️
• mouse_threshold_y — the vertical mouse acceleration threshold. when the speed of mouse movement exceeds this threshold value, the speed gets multiplied by an acceleration factor (mouse_acceleration).
• snd_samplerate — sound output sample rate, in Hz. typical values to use are 11025, 22050, 44100 and 48000. pick your frequency, bestie 🎧
• snd_cachesize — maximum number of bytes to allocate for caching converted sound effects in memory. if set to zero, there is no limit applied. unlimited, no cap, literally 🧚
• snd_maxslicetime_ms — maximum size of the output sound buffer size, in milliseconds. sound output is generated periodically in slices. higher values might be more efficient, but they'll introduce latency to the sound output. the default is 28ms (that's one slice per tic with the 35fps timer). efficiency vs. latency, the eternal struggle 😤
• snd_pitchshift — if non-zero, sound effects will have their pitch varied up or down by a random amount during play. if zero, sound effects play back at their default pitch. chaos mode or calm mode 🔥
• snd_musiccmd — external command to invoke to perform MIDI playback. if set to the empty string, SDL_mixer's internal MIDI playback is used. this only has any effect when snd_musicdevice is set to General MIDI output. yes, that's the whole condition, don't skip it 👀
• snd_dmxoption — value to set for the DMXOPTION environment variable. if this contains "-opl3", output for an OPL3 chip is generated when in OPL MIDI playback mode. vintage tech, we love her 💜
• opl_io_port — the I/O port to use to access the OPL chip. only relevant when using native OPL music playback.
• use_libsamplerate — controls whether libsamplerate support is used for performing sample rate conversions of sound effects. support for this must be compiled into the program — you can't just wish it into existence, bestie. if zero, libsamplerate support is disabled. if non-zero, libsamplerate is enabled. increasing values roughly correspond to higher quality conversion; the higher the quality, the slower the conversion process. the levels are:
  • Linear conversion = 1
  • Zero order hold = 2
  • Fast Sinc filter = 3
  • Medium quality Sinc filter = 4
  • High quality Sinc filter = 5
• libsamplerate_scale — the scaling factor used by libsamplerate. this is used when converting sounds internally back into integer form; normally it should not be necessary to change it from the default value. the only time it might be needed is if a PWAD file is loaded that contains very loud sounds, in which case the conversion may cause sound clipping and the scale factor should be reduced. the lower the value, the quieter the sound effects become, so it should be set as high as is possible without clipping occurring. precision, bestie 🎚️
• autoload_path — full path to a directory in which WAD files and dehacked patches can be placed to be automatically loaded on startup. a subdirectory of this directory matching the IWAD name is checked to find the files to load. auto-magic ✨
• music_pack_path — full path to a directory containing configuration files for substitute music packs. these packs contain high quality renderings of game music to be played instead of using the system's built-in MIDI playback. glow up for your ears 🎶
• fsynth_chorus_active — if 1, activate the FluidSynth chorus effects module. if 0, no chorus will be added to the output signal.
• fsynth_chorus_depth — specifies the modulation depth of the FluidSynth chorus. default is 5.0, range is 0.0 to 256.0.
• fsynth_chorus_level — specifies the output amplitude of the FluidSynth chorus signal. default is 0.35, range is 0.0 to 10.0.
• fsynth_chorus_nr — sets the voice count of the FluidSynth chorus signal. default is 3, range is 0 to 99.
• fsynth_chorus_speed — sets the FluidSynth chorus modulation speed in Hz. default is 0.3, range is 0.1 to 5.0.
• fsynth_midibankselect — this setting defines how FluidSynth interprets Bank Select messages. the default is "gs". other possible values are "gm", "xg" and "mma".
• fsynth_polyphony — sets the number of FluidSynth voices that can be played in parallel. default is 256, range is 1 - 65535.
• fsynth_reverb_active — if 1, activate the FluidSynth reverb effects module. if 0, no reverb will be added to the output signal.
• fsynth_reverb_damp — sets the amount of FluidSynth reverb damping. default is 0.4, range is 0.0 to 1.0.
• fsynth_reverb_level — sets the FluidSynth reverb amplitude. default is 0.15, range is 0.0 - 1.0.
• fsynth_reverb_roomsize — sets the room size (i.e. amount of wet) FluidSynth reverb. default is 0.6, range is 0.0 - 1.0.
• fsynth_reverb_width — sets the stereo spread of the FluidSynth reverb signal. default is 0.4, range is 0.0 - 100.0.
• fsynth_gain — fine tune the FluidSynth output level. default is 1.0, range is 0.0 - 10.0.
• fsynth_sf_path — full path to a soundfont file to use with FluidSynth MIDI playback.
• timidity_cfg_path — full path to a Timidity configuration file to use for MIDI playback. the file will be evaluated from the directory where it is evaluated, so there is no need to add "dir" commands into it. convenient, honestly 💅
• gus_patch_path — path to GUS patch files to use when operating in GUS emulation mode.
• gus_ram_kb — number of kilobytes of RAM to use in GUS emulation mode. valid values are 256, 512, 768 or 1024.
• winmm_midi_device — MIDI device for native Windows MIDI.
• winmm_complevel — compatibility level for native Windows MIDI, default 1. valid values are 0 (Vanilla), 1 (Standard), 2 (Full).
• winmm_reset_type — reset device type for native Windows MIDI, default 1. valid values are 0 (None), 1 (GM Mode), 2 (GS Mode), 3 (XG Mode).
• winmm_reset_delay — reset device delay for native Windows MIDI, default 0, median value 100 ms.
• vanilla_savegame_limit — if non-zero, the Vanilla savegame limit is enforced; if the savegame exceeds 180224 bytes in size, the game will exit with an error. if this has a value of zero, there is no limit to the size of savegames. so like, choose your fighter 😭
• vanilla_demo_limit — if non-zero, the Vanilla demo size limit is enforced; the game exits with an error when a demo exceeds the demo size limit (128KiB by default). if this has a value of zero, there is no limit to the size of demos.

---

💀 heads up bestie: those last two? the ones that make the game exit with an error? that's not a joke, that's fr fr real behavior. if you turn those limits on and you go over, the game is done, periodt.

---

okay that's the end of part 1 💖 more is coming, don't go anywhere 🦋

• vanilla_keyboard_mapping — bestie, set this to anything non-zero and the game goes full Vanilla Doom mode, assuming an American keyboard mapping no matter what. Set it to zero and it'll use your keyboard's native mapping instead. 🌎
• a11y_sector_lighting — if zero, this disables sectors changing their light level. 🕯️
• a11y_extra_lighting — how much extra light gets added to the game scene. ✨
• a11y_weapon_flash — if zero, this disables weapon flashes changing the ambient light level, and it also kills the flickering of torches. 🔥
• a11y_weapon_palette — if zero, this disables weapon palette changes.
• a11y_weapon_pspr — if zero, this disables rendering of weapon flashes sprites.
• a11y_palette_changes — if zero, this disables palette changes upon damage, item pickup, or when wearing the radiation suit. 🩺
• a11y_invul_colormap — if zero, this disables colormap changes during invulnerability. 💜

---

• player_name — the name to use in network games for identification. Heads up tho: this is only used on the "waiting" screen while waiting for the game to start. 🫶
• grabmouse — if this is non-zero, the mouse gets "grabbed" when running in windowed mode so it can be used as an input device. When you're running full screen, this has no effect. 🖱️
• novert — if non-zero, all vertical mouse movement is ignored. This emulates the behavior of the "novert" tool available under DOS that does the same exact thing. 🚫
• mouse_acceleration — mouse acceleration factor. When the speed of mouse movement exceeds the threshold value (mouse_threshold), the speed gets multiplied by this value. 🏎️
• mouse_threshold — mouse acceleration threshold. When the speed of mouse movement exceeds this threshold value, the speed gets multiplied by an acceleration factor (mouse_acceleration).
• mouseb_strafeleft — mouse button to strafe left. ⬅️
• mouseb_straferight — mouse button to strafe right. ➡️
• mouseb_turnleft — mouse button to turn left.
• mouseb_turnright — mouse button to turn right.
• mouseb_use — mouse button to "use" an object, eg. a door or switch. 🚪
• mouseb_backward — mouse button to move backwards.
• mouseb_prevweapon — mouse button to cycle to the previous weapon. 🔫
• mouseb_nextweapon — mouse button to cycle to the next weapon.
• dclick_use — if non-zero, double-clicking a mouse button acts like pressing the "use" key to use an object in-game, eg. a door or switch. 👆

---

• joystick_guid — SDL GUID string indicating the joystick to use. An empty string means no joystick is configured. 🎮
• joystick_index — index of the SDL joystick to use. This is only used in the case where multiple identical joystick devices are connected that have the same GUID, so it can tell them apart.
• use_analog — if non-zero, use analog movement when playing with a gamepad. 🕹️
• joystick_x_axis — joystick axis to use for horizontal (X) movement.
• joystick_x_invert — if non-zero, movement on the horizontal joystick axis is inverted. 🙃
• joystick_turn_sensitivity — joystick turn analog sensitivity, specified as a value between 0 and 20.
• joystick_y_axis — joystick axis to use for vertical (Y) movement.
• joystick_y_invert — if non-zero, movement on the vertical joystick axis is inverted. 🙃
• joystick_strafe_axis — joystick axis to use for strafing movement.
• joystick_strafe_invert — if non-zero, movement on the joystick axis used for strafing is inverted. 🙃
• joystick_move_sensitivity — joystick move and strafe analog sensitivity, specified as a value between 0 and 20.
• joystick_look_axis — joystick axis to use for looking up and down. 👀
• joystick_look_invert — if non-zero, movement on the joystick axis used for looking is inverted. 🙃
• joystick_look_sensitivity — joystick look analog sensitivity, specified as a value between 0 and 20.
• joystick_physical_button0 — the physical joystick button that corresponds to joystick virtual button #0. 🎯
• joystick_physical_button1 — the physical joystick button that corresponds to joystick virtual button #1.
• joystick_physical_button2 — the physical joystick button that corresponds to joystick virtual button #2.
• joystick_physical_button3 — the physical joystick button that corresponds to joystick virtual button #3.
• joystick_physical_button4 — the physical joystick button that corresponds to joystick virtual button #4.
• joystick_physical_button5 — the physical joystick button that corresponds to joystick virtual button #5.
• joystick_physical_button6 — the physical joystick button that corresponds to joystick virtual button #6.
• joystick_physical_button7 — the physical joystick button that corresponds to joystick virtual button #7.
• joystick_physical_button8 — the physical joystick button that corresponds to joystick virtual button #8.
• joystick_physical_button9 — the physical joystick button that corresponds to joystick virtual button #9.
• joystick_physical_button10 — the physical joystick button that corresponds to joystick virtual button #10.
• joystick_physical_button11 — the physical joystick button that corresponds to joystick virtual button #11.
• joystick_physical_button12 — the physical joystick button that corresponds to joystick virtual button #12.
• joystick_physical_button13 — the physical joystick button that corresponds to joystick virtual button #13.
• joystick_physical_button14 — the physical joystick button that corresponds to joystick virtual button #14.
• joystick_physical_button15 — the physical joystick button that corresponds to joystick virtual button #15.
• joystick_physical_button16 — the physical joystick button that corresponds to joystick virtual button #16.
• use_gamepad — if non-zero, use the SDL_GameController interface instead of the SDL_Joystick interface. 🎮
• gamepad_type — stores the SDL_GameControllerType of the last configured gamepad.
• joystick_x_dead_zone — joystick x axis dead zone, specified as a percentage of the axis max value.
• joystick_y_dead_zone — joystick y axis dead zone, specified as a percentage of the axis max value.
• joystick_strafe_dead_zone — joystick strafe axis dead zone, specified as a percentage of the axis max value.
• joystick_look_dead_zone — joystick look axis dead zone, specified as a percentage of the axis max value.
• joyb_strafeleft — joystick virtual button to make the player strafe left.
• joyb_straferight — joystick virtual button to make the player strafe right.
• joyb_menu_activate — joystick virtual button to activate the menu.
• joyb_toggle_automap — joystick virtual button to toggle the automap. 🗺️
• joyb_prevweapon — joystick virtual button that cycles to the previous weapon.
• joyb_nextweapon — joystick virtual button that cycles to the next weapon.

---

• key_pause — key to pause or unpause the game. ⏸️
• key_menu_activate — key that activates the menu when pressed.
• key_menu_up — key that moves the cursor up on the menu. ⬆️
• key_menu_down — key that moves the cursor down on the menu. ⬇️
• key_menu_left — key that moves the currently selected slider on the menu left.
• key_menu_right — key that moves the currently selected slider on the menu right.
• key_menu_back — key to go back to the previous menu.
• key_menu_forward — key to activate the currently selected menu item.
• key_menu_confirm — key to answer 'yes' to a question in the menu. ✅
• key_menu_abort — key to answer 'no' to a question in the menu. ❌
• key_menu_help — keyboard shortcut to bring up the help screen.
• key_menu_save — keyboard shortcut to bring up the save game menu. 💾
• key_menu_load — keyboard shortcut to bring up the load game menu.
• key_menu_volume — keyboard shortcut to bring up the sound volume menu. 🔊
• key_menu_detail — keyboard shortcut to toggle the detail level.
• key_menu_qsave — keyboard shortcut to quicksave the current game.
• key_menu_endgame — keyboard shortcut to end the game.
• key_menu_messages — keyboard shortcut to toggle heads-up messages.
• key_menu_qload — keyboard shortcut to load the last quicksave.
• key_menu_quit — keyboard shortcut to quit the game.
• key_menu_gamma — keyboard shortcut to toggle the gamma correction level.
• key_spy — keyboard shortcut to switch view in multiplayer. 🕵️
• key_menu_nextlevel — keyboard shortcut to go to next level.
• key_menu_reloadlevel — keyboard shortcut to restart current level or demo.
• key_menu_incscreen — keyboard shortcut to increase the screen size.
• key_menu_decscreen — keyboard shortcut to decrease the screen size.
• key_menu_screenshot — keyboard shortcut to save a screenshot. 📸
• key_menu_cleanscreenshot — keyboard shortcut to save a clean screenshot. ✨
• key_menu_del — key to delete a savegame. 🗑️
• key_map_toggle — key to toggle the map view.
• key_map_north — key to pan north when in the map view.
• key_map_south — key to pan south when in the map view.
• key_map_east — key to pan east when in the map view.
• key_map_west — key to pan west when in the map view.
• key_map_zoomin — key to zoom in when in the map view. 🔍
• key_map_zoomout — key to zoom out when in the map view. 🔎
• key_map_maxzoom — key to zoom out the maximum amount when in the map view.
• key_map_follow — key to toggle follow mode when in the map view.
• key_map_grid — key to toggle the grid display when in the map view.
• key_map_mark — key to set a mark when in the map view. 📍
• key_map_clearmark — key to clear all marks when in the map view.
• key_map_overlay — key to toggle the overlay mode when in the map view.
• key_map_rotate — key to toggle the rotate mode when in the map view. 🔄
• mouseb_mapzoomin — mouse button to zoom in when in the map view.
• mouseb_mapzoomout — mouse button to zoom out when in the map view. bestie, it's giving "get a wider view" 🗺️
• mouseb_mapmaxzoom — mouse button to zoom out the max amount when in the map view. go big or go home, max zoom energy ✨
• mouseb_mapfollow — mouse button to toggle follow mode when in the map view. so you can stalk the action 👀
• key_weapon1 — key to select weapon 1. pew pew 🔫
• key_weapon2 — key to select weapon 2. pew pew, part two 🔫
• key_weapon3 — key to select weapon 3. third weapon, third slay 💅
• key_weapon4 — key to select weapon 4. four for the win 🍀
• key_weapon5 — key to select weapon 5. five alive ✋
• key_weapon6 — key to select weapon 6. six, bestie 🎲
• key_weapon7 — key to select weapon 7. lucky number seven 🍀
• key_weapon8 — key to select weapon 8. eight, great 🎱
• key_prevweapon — key to cycle to the previous weapon. go back, bestie ⏪
• key_nextweapon — key to cycle to the next weapon. onward! ⏩
• key_message_refresh — key to re-display last message. reread the tea ☕
• key_demo_quit — key to quit the game when recording a demo. emergency exit 🚪
• key_multi_msg — key to send a message during multiplayer games. chat time 💬
• key_multi_msgplayer1 — key to send a message to player 1 during multiplayer games. slide into their DMs 📨
• key_multi_msgplayer2 — key to send a message to player 2 during multiplayer games. DM player 2 📨
• key_multi_msgplayer3 — key to send a message to player 3 during multiplayer games. DM player 3 📨
• key_multi_msgplayer4 — key to send a message to player 4 during multiplayer games. DM player 4 📨
• key_reverse — quick 180° reverse. spin around 💃
• key_toggleautorun — toggle always run. set it and forget it 🏃‍♀️
• key_togglenovert — toggle vertical mouse movement. flip that Y axis 🔄
• mouse_y_invert — invert vertical mouse movement. upside down vibes 🙃
• crispy_automapoverlay — automap overlay mode. map on top of the game 🗺️
• crispy_automaprotate — automap rotate mode. spin the map 🌀
• crispy_automapstats — show additional level statistics. extra numbers 📊
• crispy_bobfactor — variable player view bob. how much your view bounces 🏃‍♂️
• crispy_btusetimer — "Use" button timer. how long you hold to use things ⏱️
• crispy_brightmaps — apply brightmaps to select textures and sprites. glow up ✨
• crispy_centerweapon — Center Weapon when Firing. symmetrical slay 💅
• crispy_coloredblood — Enable Colored Blood. not just red 🩸
• crispy_coloredhud — Show colored numbers in the status bar. rainbow stats 🌈
• crispy_crosshairtarget — Highlight Crosshair on target. lock on 🎯
• crispy_defaultskill — Default difficulty when starting a new game. pick your poison 💀
• crispy_demobar — Show a progress bar when playing back a demo. loading screen realness 📊
• crispy_demotimer — Show a timer when recording or playing pack demos. time it right ⏲️
• crispy_demotimerdir — Timer direction whan playing back a demo. yes, 'whan', we keep it iconic 💅
• crispy_extautomap — Extended Automap. more map, more better 🗺️
• crispy_flipcorpses — Enable Mirrored Corpses. they dead but symmetrical 🧟
• crispy_fpslimit — Limit framerate to this value in frames per second. cap it 🎞️
• crispy_freeaim — Enable vertical aiming. aim up and down 🎯
• crispy_freelook — Enable looking up and down. neck gains 👀
• crispy_gamma — Crispy's variable to support intermediate and negative gamma levels. brightness beyond the norm 🌞
• crispy_hires — High Resolution Rendering. crisp like a new iPhone 📱
• crispy_jump — Enable jumping. get some air 🦘
• crispy_leveltime — Show level time. speedrun energy ⏱️
• crispy_mouselook — Use the mouse to look up and down. mouse look 🖱️
• crispy_neghealth — Negative player health. you can go below zero? iconic 💀
• crispy_overunder — Players may walk over and under shootable things. parkour 🏃
• crispy_pitch — Enable weapon recoil pitch. kickback vibes 🔫
• crispy_playercoords — Show player coordinates. know your place 📍
• crispy_secretmessage — Show a centered message and play a sound when a secret is found. secret slay 🔔
• crispy_smoothlight — Smooth Diminishing Lighting. soft glow ✨
• crispy_smoothmap — Smooth Lines on Automap. no jagged edges 🗺️
• crispy_smoothscaling — Smooth Scaling. no pixelated mess ✨
• crispy_soundfix — Misc. sound fixes. audio glow up 🔊
• crispy_soundfull — Play sounds in full length. no cut-offs 🎵
• crispy_soundmono — Mono sound effects. old school audio 🎧
• crispy_statsformat — Level Stats Format. how you see your numbers 📊
• crispy_translucency — Enable translucency. see-through realness 👻
• crispy_truecolor — Enable true-color rendering (experimental). fancy but experimental 🎨
• crispy_uncapped — Uncapped Framerate. no limits 🚀
• crispy_vsync — Enable VSync. sync it up 📺
• crispy_widescreen — Widescreen rendering. cinematic vibes 🎬

---

🔍 SEE ALSO 🔍

• crispy-doom(6)
• default.cfg(5)
• crispy-doom-setup(6)

and that's a wrap, bestie! this page is from Crispy Doom 7.1.0, dated 2024-01-23, and it's the crispy-doom.cfg(5) manual. slay 💅✨