Bottles dependencies repository

Repository for software dependencies on Bottles

There is also an online database for this repository.

How to contribute

This is a fully community driven repository. This mean that other users can open Pull Requests to provide new dependency to increase software support in Bottles!

To submit a new dependency, just commit a new manifest file. This must follow the structure:

Name: dotnet40
Description: Microsoft .NET Framework 4
Provider: Microsoft
License: Microsoft EULA
License_url: https://www.microsoft.com/web/webpi/eula/net_library_eula_enu.htm

Dependencies: [] # not implemented
Conflicts: # not implemented
- mono

Uninstaller: Microsoft .NET Framework 4 Extended
Steps: []

Steps:

install_exe can be used when you want to install a dependency (*.exe)

- action: install_exe
  file_name: vcredist_x64.exe
  url: https://download.visualstudio.microsoft.com/download/pr/10912041/cee5d6bca2ddbcd039da727bf4acb48a/vcredist_x64.exe
  rename: vcredist2013_x64.exe
  file_checksum: 49b1164f8e95ec6409ea83cdb352d8da

install_msi can be used when you want to install a dependency (*.msi)

- action: install_msi
  file_name: msxml6.msi
  url: https://download.microsoft.com/download/2/e/0/2e01308a-e17f-4bf9-bf48-161356cf9c81/msxml6.msi
  rename: vcredist2013_x64.exe
  file_checksum: a13bff305ec8ab7ab89c2a1758c55cb9

delete_sys32_dlls can be used when you need to remove system .dlls

- action: delete_sys32_dlls
  dlls:
  - comcat.dll
  - msvcrt.dll
  - oleaut32.dll
  - olepro32.dll

cab_extract can be used to exctract a Windows cabinet

- action: cab_extract
  file_name: msxml6-KB973686-enu-amd64.exe
  url: https://web.archive.org/web/20190122095451/https://download.microsoft.com/download/1/5/8/158F681A-E595-472B-B15E-62B649B1B6FF/msxml6-KB973686-enu-amd64.exe
  file_checksum: 13a292beb9ebe46ac97b8a4352fe2cd5

# or from the temp dir

- action: cab_extract
  file_name: msxml6.msi
  url: temp/msxml6

extracted files will be placed in a new directory in the bottles'temp path, its name is equal to the file_name, escaping . with _.

copy_cab_dll can be used to copy dll from an extracted Windows cabinet to the prefix

- action: copy_cab_dll
  file_name: msxml6.dll.86F857F6_A743_463D_B2FE_98CB5F727E09
  url: temp/msxml6
  dest: win32msxml6.dll

override_dll can be used to add a new DLL override

- action: override_dll
  dll: msxml6
  type: native,builtin

download_archive can be used to download an archive or Windows cabinet

- action: download_archive
  file_name: msxml6-KB973686-enu-amd64.exe
  url: https://web.archive.org/web/20190122095451/https://download.microsoft.com/download/1/5/8/158F681A-E595-472B-B15E-62B649B1B6FF/msxml6-KB973686-enu-amd64.exe
  file_checksum: 13a292beb9ebe46ac97b8a4352fe2cd5

get_from_cab can be used to take only one file from the Windows cabinet

- action: get_from_cab
  source: msxml6-KB973686-enu-amd64.exe
  file_name: msxml6.msi

extracted files can also be moved in the bottle path

- action: get_from_cab
  source: msxml6.msi
  file_name: msxml6.dll.86F857F6_A743_463D_B2FE_98CB5F727E09
  dest: drive_c/windows/system32/
  rename: msxml6.dll

The manifest name should be the same declared inside in the Name parameter, followed by the .yml extension.

Parameters:

• Name should be a concise name for the dependency, no spaces, use underscore instead (e.g. dotnet40)
• Description this is not a full description, this is just the complete name (e.g. Microsoft .NET Framework 4)
• Provider this is the dependency provider (e.g. Microsoft)
• License this is the author license (e.g. Microsoft EULA)
• License_url this is the license URL (e.g. https://www.microsoft.com/web/webpi/eula/net_library_eula_enu.htm)
• Dependencies at this time is not used, in the future it will be used to indicate other dependencies needed to install this one
• Uninstaller the name of the uninstaller (e.g. Microsoft .NET Framework 4 Extended) this will be used by wine uninstaller
• Steps this contains all steps that Bootles should perform to install this dependency, e.g.:

action: install_exe
file_name: vcredist_x64.exe
url: https://download.visualstudio.microsoft.com/download/pr/10912041/cee5d6bca2ddbcd039da727bf4acb48a/vcredist_x64.exe
rename: vcredist2013_x64.exe
file_checksum: 49b1164f8e95ec6409ea83cdb352d8da

the method install_exe can be used multiple time to install more than one executable (use install_msi with the same syntax for .msi files). The rename parameter is optional and must be used rename a downloaded file to a more specific one. Another method can be delete_sys32_dlls, this must be used to delete one or more dll from the C:\Windows\System32 path, to avoid conflicts, e.g.:

Steps:
- action: delete_sys32_dlls
  dlls:
  - comcat.dll
  - msvcrt.dll
  - oleaut32.dll
  - olepro32.dll
  - stdole2.dll

Note that every file should declare its checksum (MD5), this should used by Bottles to validate every file, checking for damaged or partials downloads.

When a pull requests is verified and merged, a moderator will add your new dependency to the index.yml file, this will make your work discoverable by Bottles.

Best practices/Rules

• Provide links to official, tangible, reliable and possibly immutable resources
• Do not self-host resources
• Don't post any copyright infringing resources
• Do not delete manifests, when a dependency should be removed from Bottles, just remove it from index.yml, unless it violates the rules, in that case it will be eliminated.