{"id":13442058,"url":"https://github.com/Winetricks/winetricks","last_synced_at":"2025-03-20T13:32:03.900Z","repository":{"id":28760516,"uuid":"32282675","full_name":"Winetricks/winetricks","owner":"Winetricks","description":"Winetricks is an easy way to work around problems in Wine","archived":false,"fork":false,"pushed_at":"2025-02-12T05:00:41.000Z","size":19804,"stargazers_count":2939,"open_issues_count":157,"forks_count":412,"subscribers_count":103,"default_branch":"master","last_synced_at":"2025-03-13T16:34:23.293Z","etag":null,"topics":["gaming","shell","wine","wine-staging","winehq","winetricks"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Winetricks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"austin987","patreon":"austin987"}},"created_at":"2015-03-15T20:36:11.000Z","updated_at":"2025-03-13T08:09:24.000Z","dependencies_parsed_at":"2023-01-16T22:16:34.335Z","dependency_job_id":"4e23dccd-8d9f-4f26-954c-c69a6c7eabd5","html_url":"https://github.com/Winetricks/winetricks","commit_stats":{"total_commits":3416,"total_committers":203,"mean_commits":16.82758620689655,"dds":0.5371779859484778,"last_synced_commit":"383292899865c41d7f9e5e77c3f09b73e72a0fde"},"previous_names":[],"tags_count":68,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Winetricks%2Fwinetricks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Winetricks%2Fwinetricks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Winetricks%2Fwinetricks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Winetricks%2Fwinetricks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Winetricks","download_url":"https://codeload.github.com/Winetricks/winetricks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244619148,"owners_count":20482369,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gaming","shell","wine","wine-staging","winehq","winetricks"],"created_at":"2024-07-31T03:01:41.175Z","updated_at":"2025-03-20T13:32:03.880Z","avatar_url":"https://github.com/Winetricks.png","language":"Shell","funding_links":["https://github.com/sponsors/austin987","https://patreon.com/austin987"],"categories":["HarmonyOS","Shell","Applications","Wine","Winetricks","shell"],"sub_categories":["Windows Manager","Games","Winetricks","Mesh networks"],"readme":"# Winetricks\n[![License](https://img.shields.io/:license-lgpl-green.svg)](https://tldrlegal.com/license/gnu-lesser-general-public-license-v2.1-(lgpl-2.1))\n\nHomepage of Winetricks, previously hosted at \u003chttps://code.google.com/p/winetricks\u003e.\n\nWinetricks is an easy way to work around problems in Wine.\n\nIt has a menu of supported applications for which it can do all the workarounds automatically. It also allows the installation of missing DLLs and tweaking of various Wine settings.\n\nThe latest version can be downloaded here:\nhttps://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks\n\nTagged releases are accessible here:\nhttps://github.com/Winetricks/winetricks/releases\n\n# Installing\nThe ```winetricks``` package should be used if it is available and up to date. The package is available in most mainstream (Unix-like) Operating Systems:\n\n* Arch: https://www.archlinux.org/packages/multilib/x86_64/winetricks/\n* Debian: https://packages.debian.org/search?searchon=names\u0026keywords=winetricks\n* Fedora: https://fedoraproject.org/wiki/Wine#Packages\n* FreeBSD: https://www.freebsd.org/cgi/ports.cgi?query=winetricks\u0026stype=all\n* Gentoo: https://packages.gentoo.org/packages/app-emulation/winetricks\n* Homebrew (OSX): https://formulae.brew.sh/formula/winetricks\n* MacPorts (OSX): https://www.macports.org/ports.php?by=name\u0026substr=winetricks\n* Slackbuilds (Slackware): https://slackbuilds.org/apps/winetricks/\n* Ubuntu: https://packages.ubuntu.com/search?keywords=winetricks\n\nNote: packaged Debian / Ubuntu winetricks versions are typically outdated, so a manual installation is recommended.\n\n## Manual Install\n\nIf the package is unavailable, outdated, or the latest version is desired, a manual installation of winetricks can be done.\nIt is _highly_ recommended to uninstall any previously installed version of winetricks first.\n\n**_If you don't uninstall a previously installed, packaged version of winetricks... Well then you get to pick up the pieces!_**\n\nE.g. for Debian / Ubuntu:\n```\nsudo apt-get purge winetricks\n```\n\n### Installing The Latest Stable Release\n\nDownload the latest release from [Github](https://github.com/Winetricks/winetricks/releases/latest).\n\nExtract the archive and `cd` into the extracted folder.\n\nRun `sudo make install` to install Winetricks system-wide.\n\n### Scripted Install\n\nYou can use a shell script to download the current winetricks script(s):\n\n```\n#!/bin/sh\n# Create and switch to a temporary directory writeable by current user. See:\n#   https://www.tldp.org/LDP/abs/html/subshells.html\ncd \"$(mktemp -d)\" || exit 1\n\n# Use a BASH \"here document\" to create an updater shell script file.\n# See:\n#   https://www.tldp.org/LDP/abs/html/here-docs.html\n# \u003e  outputs stdout to a file, overwriting any pre-existing file\n# \u003c\u003c takes input, directly from the script itself, till the second '_EOF_SCRIPT' marker, as stdin\n# the cat command hooks these 2 streams up (stdin and stdout)\n###### create update_winetricks START ########\ncat \u003e update_winetricks \u003c\u003c_EOF_SCRIPT\n#!/bin/sh\n\n# Create and switch to a temporary directory writeable by current user. See:\n#   https://www.tldp.org/LDP/abs/html/subshells.html\ncd \"\\$(mktemp -d)\"\n\n# Download the latest winetricks script (master=\"latest version\") from Github.\nwget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks\n\n# Mark the winetricks script (we've just downloaded) as executable. See:\n#   https://www.tldp.org/LDP/GNU-Linux-Tools-Summary/html/x9543.htm\nchmod +x winetricks\n\n# Move the winetricks script to a location which will be in the standard user PATH. See:\n#   https://www.tldp.org/LDP/abs/html/internalvariables.html\nsudo mv winetricks /usr/bin\n\n# Download the latest winetricks BASH completion script (master=\"latest version\") from Github.\nwget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks.bash-completion\n\n# Move the winetricks BASH completion script to a standard location for BASH completion modules. See:\n#   https://www.tldp.org/LDP/abs/html/tabexpansion.html\nsudo mv winetricks.bash-completion /usr/share/bash-completion/completions/winetricks\n\n# Download the latest winetricks MAN page (master=\"latest version\") from Github.\nwget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks.1\n\n# Move the winetricks MAN page to a standard location for MAN pages. See:\n#   https://www.pathname.com/fhs/pub/fhs-2.3.html#USRSHAREMANMANUALPAGES\nsudo mv winetricks.1 /usr/share/man/man1/winetricks.1\n_EOF_SCRIPT\n###### create update_winetricks FINISH ########\n\n# Mark the update_winetricks script (we've just written out) as executable. See:\n#   https://www.tldp.org/LDP/GNU-Linux-Tools-Summary/html/x9543.htm\nchmod +x update_winetricks\n\n# We must escalate privileges to root, as regular Linux users do not have write access to '/usr/bin'.\nsudo mv update_winetricks /usr/bin/\n```\n\nSee the manpages for the individual functions, if you are not clear how they are being used, e.g.\n```\nman mktemp\nman mv\nman wget\nman sudo\n...\n```\n\nAn alternative updater script implementation, using **su** in place of **sudo**, is also possible:\n\n```\ncd \"$(mktemp -d)\"\ncat \u003e update_winetricks \u003c\u003c_EOF_SCRIPT\n#!/bin/sh\n\ncd \"\\$(mktemp -d)\"\nwget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks\nwget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks.bash-completion\nchmod +x winetricks\nsu root sh -c 'mv winetricks /usr/bin ; mv winetricks.bash-completion /usr/share/bash-completion/completions/winetricks'\n_EOF_SCRIPT\n\nchmod +x update_winetricks\nsu root sh -c 'mv update_winetricks /usr/bin/'\n```\n\nTo use ```curl``` instead of ```wget```: substitute all ```wget``` calls with ```curl -O```, in the winetricks update script.\n\n# Updating\nUsing the traditional Unix crontab...\n```\nsudo ln \"/usr/bin/update_winetricks\" \"/etc/cron.weekly/update_winetricks\"\n```\nNote: ensure you have a cron utility installed and enabled, on systems utilizing **systemd** by default.\n\nThe update script can be automated, to run on a set schedule, via (where available) **systemd** units.\nE.g. to create a scheduled winetricks updater **systemd** **timer** unit, and an associated **systemd** **service** unit:\n```\ncd \"$(mktemp -d)\"\ncat \u003e winetricks_update.timer \u003c\u003c_EOF_TIMER_UNIT\n[Unit]\nDescription=Run winetricks update script weekly (Saturday)\n\n[Timer]\nOnCalendar=Sat\nPersistent=true\n\n[Install]\nWantedBy=timers.target\n_EOF_TIMER_UNIT\n\ncat \u003e winetricks_update.service \u003c\u003c_EOF_SERVICE_UNIT\n[Unit]\nDescription=Run winetricks update script\nAfter=network.target\n\n[Service]\nExecStart=/bin/sh /usr/bin/update_winetricks\nType=oneshot\n_EOF_SERVICE_UNIT\n\nsudo mv winetricks_update.timer winetricks_update.service /etc/systemd/system/\n```\nSee:\n* [freedesktop.org: systemd service unit](https://www.freedesktop.org/software/systemd/man/systemd.service.html)\n* [freedesktop.org: systemd timer unit](https://www.freedesktop.org/software/systemd/man/systemd.timer.html)\n\nTo start and enable the winetricks update timer:\n```\nsudo systemctl daemon-reload\nsudo systemctl enable winetricks_update.timer\nsudo systemctl start winetricks_update.timer\n```\n\nThe core winetricks script can also be updated by simply doing:\n```\nwinetricks --self-update\n```\nor:\n```\nsudo winetricks --self-update\n```\nfor a system-wide winetricks installation.\n\n# Custom .verb files\nNew dll/settings/programs can be added to Winetricks by passing a custom .verb (format below)\n\nExample `icecat.verb`:\n\n```\nw_metadata icecat apps \\\n    title=\"GNU Icecat 38.8.0\" \\\n    publisher=\"GNU Foundation\" \\\n    year=\"2016\" \\\n    media=\"download\" \\\n    file1=\"icecat-38.8.0.en-US.win32.zip\" \\\n    installed_exe1=\"${W_PROGRAMS_X86_WIN}/icecat/icecat.exe\"\n\nload_icecat()\n{\n    w_download https://ftp.gnu.org/gnu/gnuzilla/38.8.0/${file1} e5f9481e78710c25eb3a271d81aceb19ef44ff6e8599da7d5f7a2da584c01213\n    w_try_unzip \"${W_PROGRAMS_X86_UNIX}\" \"${W_CACHE}/${W_PACKAGE}/icecat-38.8.0.en-us.win32.zip\"\n}\n```\n\nNote that the file prefix (icecat.verb) and command name (icecat) must match. All metadata fields are optional, only the command name and category are required.\n\n# Tests\nThe tests need `bashate` and `shellcheck\u003e=0.4.4` installed.\nMakefile supports a few test targets:\n\n* `check` - runs './tests/winetricks-tests quick' (without first clearing $WINETRICKS_CACHE)\n* `shell-checks` - runs './tests/shell-checks'\n* `test` - runs './tests/winetricks-tests full' (and clears $WINETRICKS_CACHE first)\n* `xvfb-check` - runs './tests/winetricks-tests xvfb-check' (without first clearing $WINETRICKS_CACHE first)\n\n# Support\n* Winetricks is maintained by Austin English \u003caustinenglish@gmail.com\u003e.\n* If winetricks has helped you out, then please consider donating to the FSF/EFF as a thank you:\n  * EFF - https://supporters.eff.org/donate/button\n  * FSF - https://my.fsf.org/donate\n  * Donations towards electricity bill and developer beer fund can be sent via Bitcoin to 18euSAZztpZ9wcN6xZS3vtNnE1azf8niDk\n* I try to actively respond to bugs and pull requests on GitHub:\n  * Bugs: https://github.com/Winetricks/winetricks/issues/new\n  * Pull Requests: https://github.com/Winetricks/winetricks/pulls\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWinetricks%2Fwinetricks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWinetricks%2Fwinetricks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWinetricks%2Fwinetricks/lists"}