├── .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 |
48 |
49 |
50 | 0x4a
51 | keyboard
52 |
53 |
54 |
55 |
56 |
57 |
58 | 0x41
59 | keyboard
60 |
61 |
62 |
63 |
64 |
65 |
66 | 0x53
67 | keyboard
68 |
69 |
70 |
71 |
72 |
73 |
74 | 0x4b
75 | keyboard
76 |
77 |
78 |
79 |
80 |
81 |
82 | 0x4c
83 | keyboard
84 |
85 |
86 |
87 |
88 |
89 |
90 | 0x1000004
91 | keyboard
92 |
93 |
94 |
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 |
54 |
55 |
56 | 0x4c
57 | keyboard
58 |
59 |
60 |
61 |
62 |
63 |
64 | 0x4b
65 | keyboard
66 |
67 |
68 |
69 |
70 |
71 |
72 | 0x53
73 | keyboard
74 |
75 |
76 |
77 |
78 |
79 |
80 | 0x4a
81 | keyboard
82 |
83 |
84 |
85 |
86 |
87 |
88 | 0x41
89 | keyboard
90 |
91 |
92 |
93 |
94 |
95 |
96 | 0x1000004
97 | keyboard
98 |
99 |
100 |
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 | 
138 |
139 | 
140 |
141 |
142 |
143 |
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 |
--------------------------------------------------------------------------------