├── .gitattributes ├── .github └── ISSUE_TEMPLATE │ ├── bug_report.md │ ├── feature_request.md │ └── game-launcher-request.md ├── Gameconfigs ├── Anno 1404 │ └── Engine.ini └── Clone Hero │ ├── Clone Hero (Les Paul PS3).joystick.amgp │ ├── Clone Hero (SG Controller PS2).joystick.amgp │ └── settings.ini ├── Homura ├── LICENSE ├── Media ├── Banner.jpeg ├── Screenshot.png ├── Screenshot2.png ├── Screenshot3.png └── Screenshot4.png └── README.md /.gitattributes: -------------------------------------------------------------------------------- 1 | Homura linguist-language=Shell 2 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/bug_report.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Bug report 3 | about: Create a report to help us improve 4 | title: '' 5 | labels: bug 6 | assignees: '' 7 | 8 | --- 9 | 10 | ### Description: 11 | 12 | ### Steps to reproduce the bug: 13 | 14 | ### Logs: 15 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/feature_request.md: -------------------------------------------------------------------------------- 1 | **Is your feature request related to a problem? Please describe.** 2 | A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] 3 | 4 | **Describe the solution you'd like** 5 | A clear and concise description of what you want to happen. 6 | 7 | **Describe alternatives you've considered** 8 | A clear and concise description of any alternative solutions or features you've considered. 9 | 10 | **Additional context** 11 | Add any other context or screenshots about the feature request here. 12 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/game-launcher-request.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Game/Launcher Request 3 | about: Request for help or to add a Game/Launcher 4 | title: '' 5 | labels: enhancement 6 | assignees: Alexander88207 7 | 8 | --- 9 | 10 | Description of the Game/Launcher: 11 | 12 | Link to Installer: 13 | 14 | Current issues: 15 | -------------------------------------------------------------------------------- /Gameconfigs/Anno 1404/Engine.ini: -------------------------------------------------------------------------------- 1 | 2 | -1 3 | 2 4 | 9 5 | 6 | -------------------------------------------------------------------------------- /Gameconfigs/Clone Hero/Clone Hero (Les Paul PS3).joystick.amgp: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | Game_Pad (0) 5 | 6 | 47616d655f5061642028302900000000 7 | 8 | 9 | 10 | normal 11 | 12 | 13 | normal 14 | 15 | 16 | normal 17 | 18 | 19 | 20 | 0x48 21 | keyboard 22 | 23 | 24 | 25 | 26 | 27 | normal 28 | 29 | 30 | 31 | 32 | 33 | 0x1000013 34 | keyboard 35 | 36 | 37 | 38 | 39 | 40 | 41 | 0x1000015 42 | keyboard 43 | 44 | 45 | 46 | 47 | 55 | 63 | 71 | 79 | 87 | 95 | 96 | 97 | 98 | -------------------------------------------------------------------------------- /Gameconfigs/Clone Hero/Clone Hero (SG Controller PS2).joystick.amgp: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | /dev/uhid1 5 | 6 | 2f6465762f7568696431000000000000 7 | 8 | 9 | 10 | positive 11 | 12 | 13 | normal 14 | 15 | 16 | 17 | 0x48 18 | keyboard 19 | 20 | 21 | 22 | 23 | 24 | positive 25 | 26 | 27 | positive 28 | 29 | 30 | positive 31 | 32 | 33 | negative 34 | 35 | 36 | 37 | 38 | 39 | 0x1000013 40 | keyboard 41 | 42 | 43 | 44 | 45 | 46 | 47 | 0x1000015 48 | keyboard 49 | 50 | 51 | 52 | 53 | 61 | 69 | 77 | 85 | 93 | 101 | 102 | 103 | 104 | -------------------------------------------------------------------------------- /Gameconfigs/Clone Hero/settings.ini: -------------------------------------------------------------------------------- 1 | [offsets] 2 | audio=0 3 | video=0 4 | 5 | [video] 6 | vsync=0 7 | framerate=288 8 | msaa=2 9 | particles=1 10 | menu_background=0 11 | flames=1 12 | note_animation=20 13 | star_animation=20 14 | debug_fps=0 15 | highway_sp=1 16 | highway_lightning=1 17 | song_display=1 18 | 19 | [game] 20 | poll_rate=576 21 | no_fail=1 22 | pause_on_focus_lost=1 23 | highway_shake=1 24 | sort_filter=0 25 | gem_size=100 26 | full_playlist=0 27 | menu_music=1 28 | song_preview=1 29 | mute_on_miss=1 30 | show_hit_window=0 31 | show_bot_score=1 32 | language=0 33 | allow_duplicate_songs=0 34 | enable_cursor=1 35 | enable_lyrics=1 36 | 37 | [streamer] 38 | highway_placement=0 39 | song_export=0 40 | custom_song_export=%s%n%a%n%c 41 | 42 | [custom] 43 | background_image=-2 44 | background_video=-2 45 | song_videos=0 46 | song_backgrounds=0 47 | 48 | [volume] 49 | master_volume=100 50 | mute_volume=50 51 | guitar=100 52 | bass=100 53 | rhythm=100 54 | vocals=100 55 | drums=100 56 | keys=100 57 | song=100 58 | crowd=100 59 | sounds=100 60 | menu_volume=50 61 | preview_volume=50 62 | device=-1 63 | low_latency_mode=1 64 | backend=1 65 | 66 | [directories] 67 | path1= 68 | -------------------------------------------------------------------------------- /Homura: -------------------------------------------------------------------------------- 1 | #!/usr/local/bin/bash 2 | export NAME=Homura 3 | export VER=5.0 4 | export ALH=500 5 | export WTH=500 6 | GPU=$(glxinfo | grep "OpenGL vendor string") 7 | OSN=$(uname) 8 | export NDIR=/usr/home/$USER/.local/share/$NAME 9 | export DDIR=$NDIR/Data 10 | export LDIR=$NDIR/Library 11 | export ICO=$DDIR/$NAME.png 12 | DATE=$(date) 13 | WINEVER=$(wine --version) 14 | COPYRIGHT=$(cat "/usr/local/share/licenses/homura-$VER/BSD2CLAUSE" | grep Copyright) 15 | 16 | # Running Homura as root is not recommended. If you still want to run Homura as root, remove these 4 lines and also ensure that NDIR is proper then. 17 | if [[ $USER == *"root"* ]]; then 18 | zenity --info --width=310 --window-icon=$ICO --title="$NAME $VER" --text="$NAME can not be executed as root." 19 | exit 20 | fi 21 | 22 | # When Homura is first started. 23 | if [ ! -d "$NDIR" ]; then 24 | mkdir -p $NDIR 25 | zenity --info --width=310 --window-icon=$ICO --title="$NAME $VER - Welcome" --text="Welcome to $NAME. If you have a problem, suggestion, questions or similar, do not hesitate to open an issue on GitHub. Have Fun!" 26 | if [[ $OSN != "FreeBSD" ]]; then 27 | zenity --info --width=360 --window-icon=$ICO --title="$NAME $VER" --text="You are about to use $NAME on an unsupported system ($OSN). Please be aware that unexpected errors may occur and that your bug reports can be marked as invaild." 28 | fi 29 | SC=$(zenity --question --window-icon=$ICO --width 300 --title "$NAME $VER - One time question" --text "Do you want a shortcut of $NAME in your application menu?"; echo $?) 30 | if [[ $SC == *"0"* ]]; then 31 | if [ ! -d "/usr/home/$USER/.local/share/applications" ]; then 32 | mkdir /usr/home/$USER/.local/share/applications 33 | fi 34 | echo "[Desktop Entry] 35 | Comment= 36 | Exec=bash /usr/local/bin/$NAME 37 | Icon=$DDIR/$NAME.png 38 | Categories=Game; 39 | Name=$NAME 40 | StartupNotify=false 41 | Terminal=false 42 | TerminalOptions= 43 | Type=Application 44 | " >> /usr/home/$USER/.local/share/applications/$NAME.desktop 45 | if [[ $SC == *"1"* ]]; then 46 | echo "Shortcut will be not created" 47 | fi 48 | fi 49 | fi 50 | 51 | # Creating the subfolders 52 | if [ ! -d "$NDIR/Games" ]; then 53 | mkdir $NDIR/Games 54 | fi 55 | 56 | if [ ! -d "$NDIR/Programs" ]; then 57 | mkdir $NDIR/Programs 58 | fi 59 | 60 | if [ ! -d "$DDIR" ]; then 61 | mkdir $NDIR/Data 62 | fi 63 | 64 | if [ ! -f "$ICO" ]; then 65 | cd $DDIR 66 | fetch http://alt.magzu.net/damn/dl/Homura.png 67 | fi 68 | 69 | if [ ! -d "$LDIR" ]; then 70 | mkdir -p $LDIR 71 | cd $LDIR 72 | fetch https://github.com/the-homura-project/homura/archive/library.zip 73 | unzip library.zip 74 | mv $LDIR/homura-library/* $LDIR 75 | cd $LDIR/ 76 | chmod +x * 77 | rm -r -d $LDIR/homura-library 78 | rm library.zip 79 | rm LICENSE 80 | ln -s $LDIR/Custom-Prefix $LDIR/Custom-Prefixes 81 | fi 82 | 83 | # The Applists 84 | export APPLIST=$(cd $LDIR && ls | grep -v fixes) 85 | export APPEXISTCHECK=$(cd "$NDIR/Games" && ls && cd "$NDIR/Programs" && ls && cd "$NDIR" && ls | grep "Custom-Prefixes" ) 86 | 87 | # Small checks to ensure that the user knows that no correct drivers are running. 88 | if [[ $GPU == *"VMware, Inc."* ]]; then 89 | zenity --info --width=420 --window-icon=$ICO --title="$NAME $VER" --text="$NAME have detected that you are using the fallback drivers, please check your gpu driver installation. If you should run $NAME in a virtual machine or you have enabled software rendering then you can ignore this message." 90 | fi 91 | 92 | if [[ $GPU == *"Mesa Project"* ]]; then 93 | zenity --info --width=420 --window-icon=$ICO --title="$NAME $VER" --text="$NAME have detected that you are using the fallback drivers, please check your gpu driver installation. If you should run $NAME in a virtual machine or you have enabled software rendering then you can ignore this message." 94 | fi 95 | 96 | # Functions :) 97 | function download { 98 | zenity --notification --window-icon=$ICO --text "Downloading $INST $UPDE" 99 | fetch --retry $1 100 | } 101 | 102 | function prefix-message { 103 | zenity --notification --window-icon=$ICO --text "Setup prefix" 104 | } 105 | 106 | function installer-message { 107 | zenity --notification --window-icon=$ICO --text "Starting installation" 108 | } 109 | 110 | function warn { 111 | zenity --warning --width=400 --window-icon=$ICO --title "$NAME $VER - $TODO" --text "$1" 112 | } 113 | 114 | function info { 115 | zenity --info --width=400 --window-icon=$ICO --title "$NAME $VER - $TODO" --text "$1" 116 | } 117 | 118 | export -f download 119 | export -f prefix-message 120 | export -f installer-message 121 | export -f warn 122 | export -f info 123 | 124 | # CLI 125 | Install() { 126 | CLI=1 127 | export INST=$1 128 | export TODO=Installation 129 | bash $LDIR/$1 130 | } 131 | 132 | Launch() { 133 | CLI=1 134 | export LNCH=$1 135 | export TODO=Launcher 136 | bash $LDIR/$1 137 | } 138 | 139 | Uninstall() { 140 | CLI=1 141 | export UNST=$1 142 | export TODO=Uninstallation 143 | bash $LDIR/$1 144 | } 145 | 146 | "$@" 147 | 148 | # Small informations in the terminal 149 | echo -e "\e[32m$COPYRIGHT All rights reserved." 150 | echo -e "\e[93mWelcome to $NAME $VER have fun!" 151 | echo -e "\e[3;5;0;92mRunning on $OSN $(uname -r)" 152 | echo -e "\e[3;5;0;36mWine Version: $WINEVER\e[30;48;5;82m\e[0m" 153 | echo -e "\e[3;5;0;31mGPU Info OpenGL:\e[30;48;5;82m\e[0m" && glxinfo | grep OpenGL 154 | echo -e "\e[3;5;0;31mGPU Info Vulkan:\e[30;48;5;82m\e[0m" && vulkaninfo | grep -m 1 "GPU id" 155 | 156 | # Initial menu 157 | if [ -z "$CLI" ] 158 | then 159 | export TODO=$(zenity --list --radiolist --window-icon=$ICO --height=450 --width 300 --title="$NAME $VER" --text "What do you want to do?" --hide-header --column "$NAME" --column "Item" FALSE "Installation" FALSE "Launcher" FALSE "Uninstallation" FALSE "Winetricks" FALSE "Run a executable in prefix" FALSE "Update" FALSE "Applying a fix" FALSE "Open Homura folder" FALSE "Enable logging" FALSE "Other" FALSE "About" FALSE "Exit") 160 | 161 | if [[ $TODO == *"Installation"* ]]; then 162 | export INST=$(zenity --list --title="$NAME $VER - $TODO" --window-icon=$ICO --text "What do you want to install?" --height=$ALH --width=$WTH --column="Application" $APPLIST) 163 | if [[ -z "$INST" ]]; then 164 | info "Nothing was selected for installation :/" 165 | unset INST 166 | exec $NAME 167 | else 168 | cd $DDIR 169 | bash $LDIR/$INST 170 | zenity --notification --window-icon=$ICO --text "Task completed!" 171 | unset INST 172 | fi 173 | fi 174 | 175 | if [[ $TODO == *"Launcher"* ]]; then 176 | export LNCH=$(zenity --list --title="$NAME $VER - $TODO" --window-icon=$ICO --text "What do you want to launch?" --height=$ALH --width=$WTH --column="Application" $APPEXISTCHECK) 177 | if [[ -z "$LNCH" ]]; then 178 | info "Nothing was selected to launch :/" 179 | unset LNCH 180 | exec $NAME 181 | else 182 | bash $LDIR/$LNCH 183 | zenity --notification --window-icon=$ICO --text "Task completed!" 184 | unset LNCH 185 | fi 186 | fi 187 | 188 | if [[ $TODO == *"Uninstallation"* ]]; then 189 | export UNST=$(zenity --list --title="$NAME $VER - $TODO" --window-icon=$ICO --text "What do you want to uninstall?" --height=$ALH --width=$WTH --column="Application" $APPEXISTCHECK) 190 | if [[ -z "$UNST" ]]; then 191 | info "Nothing was selected for uninstallation :/" 192 | unset UNST 193 | exec $NAME 194 | else 195 | bash $LDIR/$UNST 196 | zenity --notification --window-icon=$ICO --text "Task completed!" 197 | unset UNST 198 | fi 199 | fi 200 | 201 | if [[ $TODO == *"Winetricks"* ]]; then 202 | cd $NDIR 203 | PREFIX=$(zenity --file-selection --directory --title="Choose your prefix" --filename="/usr/home/$USER/.local/share/$NAME/") 204 | WINEPREFIX=$PREFIX winetricks 205 | fi 206 | 207 | if [[ $TODO == *"Run a executable in prefix"* ]]; then 208 | cd $NDIR 209 | PREFIX=$(zenity --file-selection --directory --title="Choose your prefix" --filename="/usr/home/$USER/.local/share/$NAME/") 210 | WINEPREFIX=$PREFIX 211 | EXECUTABLE="$(zenity --file-selection --title="Choose your executable")" 212 | WINEPREFIX=$PREFIX wine $EXECUTABLE 213 | fi 214 | 215 | if [[ $TODO == *"Update"* ]]; then 216 | export UPDE=$(zenity --list --title="$NAME $VER - $TODO" --window-icon=$ICO --text "What do you want to update?" --height=$ALH --width=$WTH --column="Application" $APPEXISTCHECK) 217 | bash $LDIR/$UPDE 218 | fi 219 | 220 | if [[ $TODO == *"Applying a fix"* ]]; then 221 | bash $LDIR/fixes 222 | fi 223 | 224 | if [[ $TODO == *"Open Homura folder"* ]]; then 225 | xdg-open $NDIR 226 | fi 227 | 228 | if [[ $TODO == *"Enable logging"* ]]; then 229 | mkdir -p $NDIR/Logs 230 | cd $NDIR/Logs 231 | zenity --info --window-icon=$ICO --width=300 --title="$NAME $VER - About" --text="Logging for this session has been enabled, you will later find the log file in the log folder." 232 | bash $NAME >> "$DATE.log" 2>&1 233 | notify-send "The logging have been quit." 234 | fi 235 | 236 | if [[ $TODO == *"Other"* ]]; then 237 | OTR=$(zenity --list --radiolist --window-icon=$ICO --height=250 --width 250 --title="$NAME $VER - $TODO" --text "What do you want to do?" --hide-header --column "$NAME" --column "Item" FALSE "Use software rendering" FALSE "Delete & reset everything" FALSE "Create a shortcut" FALSE "GitHub page" FALSE "Update library") 238 | 239 | if [[ $OTR == *"Use software rendering"* ]]; then 240 | LIBGL_ALWAYS_SOFTWARE=1 $NAME 241 | zenity --notification --window-icon=$ICO --text "You are using now hardware rendering again." 242 | fi 243 | 244 | if [[ $OTR == *"Delete & reset everything"* ]]; then 245 | DRQ=$(zenity --question --window-icon=$ICO --width 300 --title "$NAME $VER - $OTR" --text "Do you really want to delete and reset everything?"; echo $?) 246 | if [[ $DRQ == *"0"* ]]; then 247 | rm -r -d $NDIR 248 | if [ -f "/usr/home/$USER/.local/share/applications/$NAME.desktop" ]; then 249 | rm "/usr/home/$USER/.local/share/applications/$NAME.desktop" 250 | else 251 | echo -e "\e[40;38;5;32mNo shortcut was created\e[30;48;5;82m\e[0m" 252 | fi 253 | if [ -d "/usr/home/$USER/.local/share/applications/$NAME" ]; then 254 | rm -r -d "/usr/home/$USER/.local/share/applications/$NAME" 255 | else 256 | echo -e "\e[40;38;5;32mNo shortcut from $NAME was created\e[30;48;5;82m\e[0m" 257 | fi 258 | zenity --info --window-icon=$ICO --width=200 --title="$NAME $VER - $OTR" --text="All files of $NAME have been deleted, we hope you had a good time." 259 | exit 260 | fi 261 | fi 262 | fi 263 | 264 | if [[ $OTR == *"Create a shortcut"* ]]; then 265 | export CS=$(zenity --list --title="$NAME $VER - $TODO" --window-icon=$ICO --text "Of what application do you want to create a shortcut?" --height=$ALH --width=$WTH --column="Application" $APPEXISTCHECK) 266 | if [[ -z "$CS" ]]; then 267 | info "Nothing was selected :/" 268 | exec $NAME 269 | fi 270 | bash $LDIR/$CS 271 | fi 272 | 273 | if [[ $OTR == *"GitHub page"* ]]; then 274 | xdg-open https://github.com/the-homura-project/homura 275 | fi 276 | 277 | if [[ $OTR == *"Update library"* ]]; then 278 | rm -r -d $LDIR 279 | fi 280 | 281 | if [[ $TODO == *"About"* ]]; then 282 | info "Inspired by Lutris. 283 | $NAME is a launcher that makes it easy to run Windows games/launcher easily on FreeBSD by providing the required fixes and workarounds. 284 | The Windows emulation is provided by Wine. 285 | $NAME is licensed under the BSD 2-Clause License. 286 | $COPYRIGHT 287 | All rights reserved." 288 | fi 289 | 290 | if [[ $TODO == *"Exit"* ]]; then 291 | zenity --notification --window-icon=$ICO --text "Thanks for using $NAME and have a great day!" 292 | exit 293 | fi 294 | fi 295 | 296 | if [ -z "$CLI" ] 297 | then 298 | exec $NAME 299 | fi 300 | 301 | zenity --notification --window-icon=$ICO --text "Task completed!" 302 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | BSD 2-Clause License 2 | 3 | Copyright (c) 2019-2020, The Homura Project 4 | All rights reserved. 5 | 6 | Redistribution and use in source and binary forms, with or without 7 | modification, are permitted provided that the following conditions are met: 8 | 9 | 1. Redistributions of source code must retain the above copyright notice, this 10 | list of conditions and the following disclaimer. 11 | 12 | 2. Redistributions in binary form must reproduce the above copyright notice, 13 | this list of conditions and the following disclaimer in the documentation 14 | and/or other materials provided with the distribution. 15 | 16 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 17 | AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 19 | DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 20 | FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21 | DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 22 | SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 23 | CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24 | OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 25 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 | -------------------------------------------------------------------------------- /Media/Banner.jpeg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pehsa/Homura/3f0ff1d8314ecae0a30bcf9bace752f7ae36f4f3/Media/Banner.jpeg -------------------------------------------------------------------------------- /Media/Screenshot.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pehsa/Homura/3f0ff1d8314ecae0a30bcf9bace752f7ae36f4f3/Media/Screenshot.png -------------------------------------------------------------------------------- /Media/Screenshot2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pehsa/Homura/3f0ff1d8314ecae0a30bcf9bace752f7ae36f4f3/Media/Screenshot2.png -------------------------------------------------------------------------------- /Media/Screenshot3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pehsa/Homura/3f0ff1d8314ecae0a30bcf9bace752f7ae36f4f3/Media/Screenshot3.png -------------------------------------------------------------------------------- /Media/Screenshot4.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/pehsa/Homura/3f0ff1d8314ecae0a30bcf9bace752f7ae36f4f3/Media/Screenshot4.png -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # The original project moved: 2 | 3 | First it was moved to GitLab: 4 | https://gitlab.com/Alexander88207/Homura 5 | 6 | Later on CodeBerg: 7 | https://codeberg.org/Alexander88207/Homura 8 | 9 | Later changed it's name to Suyimazu: 10 | https://codeberg.org/Alexander88207/Suyimazu 11 | 12 | Now it's Mizutamari: 13 | https://codeberg.org/Alexander88207/Mizutamari 14 | 15 |

16 | 17 |

18 | 19 |

20 | 21 |

22 |

23 | Status    24 | Library    25 | Tweaks    26 | Borked    27 | Working Games    28 | Handbook    29 | Hints    30 | Contributing 31 |

32 | 33 | # Introduction :microphone: 34 | 35 | Inspired by [Lutris](https://github.com/lutris/lutris), we would like to provide a game launcher to play Windows games on FreeBSD. 36 | 37 | Its also possible now to run much steam games with the linuxulator by using the [linux-steam-utils](https://www.freshports.org/games/linux-steam-utils). 38 | 39 | # Description 📘 40 | 41 | Homura is a launcher that makes it easy to run Windows games/launcher easily on FreeBSD by providing the requiered fixes and workarounds. 42 | 43 | The Windows emulation is provided by [Wine](https://www.winehq.org). 44 | 45 | # Homura is NOT :no_entry_sign: 46 | 47 | - [Akin to CrossOver or Lutris](https://www.phoronix.com/scan.php?page=news_item&px=Homura-FreeBSD-Gaming) 48 | - [Similar to Wine](https://www.freebsdnews.com/2019/09/06/homura-windows-games-launcher-for-freebsd) 49 | 50 | # Run dependencies :syringe: 51 | 52 | Hardware: 53 | - A x86 CPU with 1,4 GHz or better 54 | - A GPU with OpenGL 3.0 & 128MB VRAM or better 55 | 56 | Software: 57 | - [shells/bash](https://www.freshports.org/shells/bash) 58 | - [archivers/p7zip](https://www.freshports.org/archivers/p7zip/) 59 | - [x11/zenity](https://www.freshports.org/x11/zenity) 60 | - [devel/xdg-utils](https://www.freshports.org/devel/xdg-utils) 61 | - [x11-fonts/webfonts](https://www.freshports.org/x11-fonts/webfonts) 62 | - [audio/mixertui](https://www.freshports.org/audio/mixertui) ([Optional](https://github.com/the-homura-project/homura/wiki/Hints#if-you-are-new-to-freebsd-wink)) 63 | - [emulators/winetricks](https://www.freshports.org/emulators/winetricks) 64 | - [devel/vulkan-tools](https://www.freshports.org/devel/vulkan-tools) 65 | - [graphics/mesa-demos](https://www.freshports.org/graphics/mesa-demos) 66 | - [x11-fonts/noto-extra](https://www.freshports.org/x11-fonts/noto-extra) (Optional) 67 | - [x11/antimicro](https://www.freshports.org/x11/antimicro) ([Optional](https://github.com/the-homura-project/homura/wiki/Controllers#guitar-hero-world-tour-guitar-pc--guitar-hero-3-guitar-les-paul-ps3)) 68 | - [emulators/i386-wine](https://www.freshports.org/emulators/i386-wine) on amd64 or [emulators/wine](https://www.freshports.org/emulators/wine) on i386 69 | 70 | # Installation/Uninstallation :cd: 71 | 72 | ### Installing from FreeBSD repository 📦 73 | 74 | Note: Packages can lag behind ports. If you want the latest version you may want to use the `latest` repository instead of `quarterly` or build the package yourself. 75 | 76 | `# pkg install games/homura` 77 | 78 | ### Build & installing the port ⚙️ 79 | 80 | `cd /usr/ports/games/homura/ && make install clean` 81 | 82 | ### Uninstallation 83 | 84 | `# pkg uninstall games/homura` 85 | 86 | To also delete the related games etc... 87 | 88 | Use the "Delete and reset everything" function. 89 | 90 | # Usage :computer: 91 | 92 | Homura was created for the gui usage in the first place, the gui can be opened via the commandline `Homura` but also via a shortcut (if you have Homura allowed to create one). 93 | 94 | For terminal fans there are also some fast commands: 95 | 96 | Examples: 97 | 98 | - To install something use `Homura Install Steam` 99 | - To launch something use `Homura Launch Steam` 100 | - To uninstall something use `Homura Uninstall Steam` 101 | 102 | # Feature / To-Do list 103 | 104 | Features | Done? 105 | ------------ | ------------- 106 | Installation launching & uninstallation of our collection of applications | :heavy_check_mark: 107 | Custom prefixes | :heavy_check_mark: 108 | Shortcut creation | :heavy_check_mark: 109 | Delete & reset everything | :heavy_check_mark: 110 | Enable/Disable DXVK | :heavy_multiplication_x: 111 | Sandboxing | :heavy_multiplication_x: 112 | SteamCMD (steam-console-client) | :heavy_check_mark: 113 | Changing between wine versions | :heavy_multiplication_x: 114 | Developer Mode | :heavy_multiplication_x: 115 | 116 | # Limitations :x: 117 | 118 | - Only 32-Bit Games and Applications working currently. You may want to see https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=242625 119 | - No winevulkan for 32bit Wine on amd64. Reason: There are no options to build i386-wine-devel with vulkan. 120 | 121 | # Chat :speech_balloon: 122 | 123 | You need help, want to help or just want to talk /人◕ ‿‿ ◕人\ ? 124 | 125 | Join our [Discord](https://discord.gg/JBKcdNt) or contact me on [Steam](https://steamcommunity.com/id/Alexander88207) 126 | 127 | # Credits :star: 128 | 129 | - [Alexander88207](https://github.com/Alexander88207) - Lead programmer & Maintainer 130 | - [MagZu](https://github.com/magzu) - Hosting the mirror (homura.magzu.net) 131 | - [You?](https://github.com/the-homura-project/homura/wiki/Contributing) 132 | 133 | Also special thanks to the port maintainers of i386-wine-devel and wine-devel. 134 | 135 | # Screenshots 136 | 137 | ![](https://raw.githubusercontent.com/the-homura-project/homura/master/Media/Screenshot.png "Screenshot") 138 | 139 | ![](https://raw.githubusercontent.com/the-homura-project/homura/master/Media/Screenshot4.png "Screenshot") 140 | 141 | Monitor 142 | 143 | Monitor 144 | 145 | # Videos 146 | 147 | Preview: https://www.youtube.com/watch?v=6B1h0F4rIs4 148 | 149 | - Review by RoboNuggie: https://www.youtube.com/watch?v=0lLs3JxezBM 150 | - Review by Linux Lounge: https://www.youtube.com/watch?v=BLNuRwLm2FI 151 | - BSD-PL November 2019: https://www.youtube.com/watch?v=X68aGybmHwI&t=2029s 152 | --------------------------------------------------------------------------------