この FAQ (Frequently Asked Questions) は Wine に関する一般的な話題を取り扱っています。Wine のソフトウェア開発に関する問題に関しては developer FAQ を参照してください。

クイックリンク: Wine でプログラムを実行, 端末から Wine で実行, アプリケーションをアンインストール, デバッグログを取得, プログラムを root 権限で実行

1. 一般的な質問

1.1. Wine に関与しているのは誰ですか?

Wine は世界中の人々の働きのおかげで入手することができます。また、CodeWeavers、 Bordeaux、 TransGaming、 Corel、 Macadamian、 Googleと多くの会社におかげによって Wine の開発は行われています。また、Acknowledgements、 Wine の歴史のページも御覧ください。

1.2. Wine は Linux や他のオペレーティングシステムを損なわせているのですか?

Wine は Linux の有用性を向上させます。ユーザーの Linux への移行をより簡単にし、Windows ソフト開発者がより簡単に Linux 上で動くソフトを作ることができます。Debunking Wine Myths で完全な答えを御覧ください。

1.3. Wine はエミュレータですか？不適切であると思えるのですが。

この事についてはたくさんの混乱があります、特に Wine の名前を間違って受け取り、WINdows Emulator と呼ぶ際に起こります。

ユーザーはエミュレータというものを考えたとき、ゲーム機のエミュレータや仮想ソフトウェアのような物として考える傾向があります。 しかしながら、 Wine は互換レイヤーなのです。 これによって、 Windows が動作している方法とほぼ同じ方法で Windows アプリケーションが動作します。「エミュレーション」固有のスピードの低下が、Wine を使う上ではないのです。また、アプリケーションを実行させる前に Wine を起動させる必要もありません。

そういう訳で、Wine は Windows Vista が Windows XP をエミュレートしているのと同じ方法で、Windows をエミュレートしていると考える事が出来ます。両方ともシステムコールを翻訳するという同じ方法で、アプリケーションを動かすことを可能にしています。Wine の設定を Windows XP に模倣させるようにすることは、Vista でアプリケーションを XP 互換モードで起動させる設定にすることと大差はありません。

Wine には単なるエミュレータ以上の点がいくつかあります。

• Wine のセクションは、Windows上で使うことが出来ます。一部の仮想マシンでは、3D ハードウェアエミュレータではなく Windows に搭載されている Direct3D の Wine による OpenGL ベースの実装成果を使用しています。
• Winelib は Wine が動作する様々なオペレーティングシステム、様々なプロセッサ、たとえ Windows 自体がサポートしないプロセッサでも Windows アプリケーションのソースコードを移植するのに使うことが出来ます。

「Wine はエミュレータだけではない」がより正確なのです。Wine をまさにエミュレータとして考える事は、以上のような事について本当に忘れているのです。Wine の「エミュレータ」は Windows アプリケーションを Wine API で交換させ、結びつける事を可能にする、まさに単なるバイナリローダなのです。

1.4. Wine・CrossOver・Cedega の違いは?

Wine はそれらのプロジェクトのベースとなっています。Wine は完璧ではありませんが、それでも1万もの人が多くの Windows プログラムを動かすことに成功し、"そのまま"の Wine を使っています。

CrossOver (以前の CrossOver Office) は CodeWeavers と呼ばれる会社の商品で、Wine がじかにベースなっており、いくつかの調整とプロプライエタリな拡張機能が加えられています。隔週ごとにリリースされる Wine と違い、 CrossOver のリリースは CodeWeavers がサポートするアプリケーションで "regressions(退行)" が起こらないように互換性を確認するテストが厳格に行われます。また、CodeWeavers は Wine 開発者の大部分を雇っており、このプロジェクトの多くの指揮を取っています。そして Wine で行われた改良はゆくゆく CrossOver に組み込まれます。

Cedega (以前の WineX) は TransGaming と呼ばれる会社の商品です。TransGaming は2002年に Wine をベースにクローズドソースで(この頃の Wine は現在とは違うライセンス形態でした)、ゲームに特化したバージョンとして Cedega を製作しました。Cedega は元々 Wine から作られていましたが、現在では Wine と Cedega はほとんど無関係に開発が行われています。現在、TransGamingは非常にわずかながら Wine にコードを提供しています。Cedega は「ゲームをもっとサポートする Wine」 ではありません。なぜなら、Wine は Cedega が開発される前から開発がされており、実際、多くのゲームは Cedega で動かすよりも Wine で動かした方がうまく動作するからです。現在、Wine は Cedega よりもさらに進んだ Direct3D の機能を持っています、 but Cedega still has more advanced copy protection support due to TransGaming's licensing of (closed source) code from a handful of copy protection companies. CrossOver と違い、Wine で行われた多くの改善は Wine と Cedega のライセンス形態の違いが存在しているため Cedega に組み込まれることはありません。

さらなる情報は、Wine の歴史を参照してください。

1.5. コマンドラインを使わなければならない?

Wine を使うためにコマンドラインを使う必要はありません。ほとんどの事は Windows と同じように GUI でできます。多くの場合インストーラを右クリックし"Wine で開く"を選択したり、ダブルクリックするだけでインストールできます。インストールされたプログラムはショートカットアイコンやメニューを使って起動できます。

たとえ最近のバージョンを使っていても、コマンドラインを使いたくなる場合があるでしょう。その最も多い理由はプログラムが正しく動かないときにデバッグ出力を得るためです。またメニューにショートカットを持っていない regedit のようなユーティリティも使いたくなるかもしれません。

This does not hold true for Mac OS X Wine usage, which is all command line currently, unless you use a Third party app.

1.6. Wine で動かしたいアプリケーションは動くでしょうか?

たぶん! もしそのアプリケーションがある程度有名なら、アプリケーションデータベースで他のユーザの動作報告を見つけることができるでしょう。しかし、最新バージョンのWineについての報告がない場合、最善の策は挑戦してみることです。

1.7. Wine ではどのようなアプリケーションがよく動きますか?

何千ものアプリケーションが正しく動作します。一般的に、単純だったり古いアプリケーションはよく動く傾向があり、複雑なアプリケーションやゲームの最新版はまだよく動かない傾向があります。個々のアプリケーションの詳細はアプリケーションデータベースを参照してください。Silver や Gold や Platinum と評価されているアプリケーションはたぶん動くでしょう。(もし、Bronze や Garbage のレーティングなら、多くのユーザーが Wine でアプリケーションを動かす準備ができていないことを差します。)

1.8. Wine を実行するには?

Wine はひとつのアプリケーションとして実行するものではありません。Wine は Windows アプリケーションを実行するのを可能にします。Windows でするのを同じようにアプリケーションをインストールし、実行するだけです。参照: Wine を使ってインストーラを実行するには？.

1.9. どのような方法で Wine プロジェクトに貢献することができますか?

プログラミングやドキュメントを記述したり、金銭的、機材的な寄付を行う事によって、完成を目指している Wine 開発者を支援することが出来ます。

また、Wine を利用しているどのユーザーにでも貢献できる事の一つに、Wine を使用中に遭遇したバグについてプロジェクトの Bugzilla に高品質のバグレポートを送信していただき、開発者が調査する際に協力をしていただくというのがあります。開発者が市場に存在しているあらゆるプログラムの複製を行うことは、現実的に不可能です。そこで、バグレポートを送信していただいた後も引き続きユーザーの助けが必要です。もし開発者がそのバグを引き起こしていることについて確かな見解があるのなら、パッチは試したかどうか尋ねたり、パッチが問題を直したかどうか調べたりするかもしれません。もしこのパッチがうまく動作する場合、メインの開発ツリーに加えられます。また、このバグレポートは閉じられ、ユーザーの協力は誰もから認められ、この問題は修正されるでしょう。

Wine プロジェクトを助けるアイデア一覧については、helping Wine pageのページを調べてみてください。

2. Wine のインストール

2.1. どのバージョンの Wine を使うべき?

短い答え: 実行したいアプリケーションが動くバージョンを使ってください。ほとんどの場合、それは最新の開発版ですが、それを探すために試行錯誤が必要な場合もあります。

長い答え: Wine の開発は開発版ブランチでの新しいリリースは約 2 週間ごとであるくらい高速です。機能性はたいてい最新開発版が一番でしょうが、Wine への変更が古いバージョンの方が新しいバージョンよりうまく動くという regressions (退行) と呼ばれる現象を起こすことがあります。

経験則的に使っているディストリビューションにインストールされた Wine のバージョンを使ってみて、使いたいアプリケーションが動くかどうか見てみるのが良いでしょう。もし動けばそれでいいし、動かなければ、アップグレードするのがよいでしょう。多くの場合、アップグレードは最新開発版にするべきですが、既知の regression (退行) を Bugzilla や AppDB でチェックするのもいい考えでしょう。もし退行があれば、そのアプリケーションが動くと知られているもっとも最近のバージョンにアップグレードしてください。

Note that while Wine does have a "stable" branch, the term "stable" refers to the branch as a whole, which is infrequently updated, and only with bugfixes promised not to cause regressions. The initial stable release, 1.0.x, had only one update in two years. Users of a development release can achieve the same degree of stability by simply not upgrading.The current stable release is 1.2; versions older than that are no longer supported.

Ubuntu users: prior to the official release of Wine 1.2 on July 16, 2010, the "wine1.2" package in Ubuntu Karmic 9.10 (and up) was actually the 1.1.x development version. The Ubuntu "wine1.2" package is now the stable 1.2 release. This unfortunate choice in naming has led to a great deal of confusion. Before seeking help on the forum/mailing list or IRC, please verify the version of Wine you have installed by typing wine --version in a terminal, and if it is not 1.2 or later, upgrade.

2.2. Wine をインストールするには?

使っているディストリビューションの既にコンパイルされたバイナリパッケージが一番良いでしょう。リンクや追加の情報については Wine ダウンロードページを参照してください。もしディストリビューションに最近のバージョンの Wine のパッケージが見つからなければ、Wine をソースからコンパイルすることができます。

2.3. 複数のバージョンの Wine を使うことはできますか?

はい、しかし複数のディストリビューションのパッケージをインストールすることができないので、 Wine をあなた自身でビルドする必要があるでしょう。 (参照: ソースコードから Wine をコンパイルするには) Wine をビルドしたディレクトリから ("make install" せず) 実行するのが最も簡単な方法です。複数のバージョンをインストールしたいなら、Wine をビルドときに --prefix をそれぞれのバージョンに異なったインストールディレクトリを指定するのに使ってください。例:

./configure prefix=/path/to/install/directory && make

そしてインストールには

sudo make install

複数のバージョンをインストールするかビルドしたディレクトリから実行するかに関係なく、アプリケーションを実行するときには、使用したい Wine のバージョンを指定しなければならないことに注意してください。また異なった Wine のバージョンで実行するアプリケーションは別々の wineprefixes にインストールすることを勧めます。

2.4. Wine は 64ビット環境で実行できますか?

はい。普通、32 ビットと同じようにディストリビューションの Wine パッケージをインストールするだけでインストールできるはずです。ダウンロードページを確認してください。もしソースから Wine をビルドする必要があるのなら、WineOn64bit を参照してください。

64ビット環境向け Wine は実際には32ビットモードで実行されることに注意してください。基本的にすべての Windows アプリケーションが32ビットであることが必要です。64ビット Windows アプリケーションのサポートは現在実験段階です。(参照: Wine64)

• Wine は現在 32ビット版で提供されます。16ビットと32ビットの Windows アプリケーションが動きます。32ビットと64ビットの Linux・Unix 環境で動作します。
• Wine は実験的に64ビット版も提供しています。32ビットと64ビットの Windows アプリケーションが (たぶん) 動きます。64ビットの Linux 環境でのみ動作します。

2.5. Apple でのインストール

2.5.1. Mac で Wine をインストールするには?

Mac OS X を使っているなら、Mac OS X FAQ を見てください。もしこれが分かりにくいなら、Mac 用 Codeweavers' Crossover のようなサードパーティのアプリケションがあります。

Wine のインストールを Linux でと同じくらい簡単にするために Mac のパッケージをビルドする人を探しています。もし協力してくれるなら、開発者向けメーリングリストに連絡してください。

もし、 Mac で Linux を動かしているのであれば、PC での Linux 環境へのインストールのように簡単に Wine をインストールできます。ダウンロードページを見てください。

2.5.2. Intel チップでない古いほうの Mac で Wine を使うことはできますか?

いいえ、たとえ Linux を使っても。古い Mac は CPU エミュレータの下で実行しない限り x86 (Intel と AMD) 用にコンパイルされたコードと互換性のない PowerPC プロセッサを使っていました。 Wine は (CPU) エミュレータではありません。The Darwine project, however, is an effort to do just that.

2.6. ネットブック (eeePC, Acer, Aspire One など) に Wine をインストールするには?

If you have replaced the customized distro that came preinstalled on your netbook (Xandros, Linpus, etc.) with one of the mainstream distros that provide up-to-date Wine packages, you should be able to install Wine as normal for that distro.

If you are still using Xandros (eeePC), Linpus (Acer Aspire One) or any other customized distro that came preinstalled on your netbook, you will have to ask on your netbook's support forum. Only other users of those distros can advise you on what, if any, binary packages will work on your system, where to find them, and how to install them.

You can also try building Wine from source following the instructions in the Wine User Guide, but you will still need to consult your netbook's support forum regarding satisfying dependencies on your particular system.

2.7. ソースコードから Wine をコンパイルするには?

• 推奨パッケージがインストールされているか確認してください。

• Git を使って Wine を入手するか、最新版 tarball をダウンロードし、展開してください。

• パッチを適用したいなら、Wine のソースディレクトリで patch -p1 < foo.patch のようなコマンドを実行してください。You may have to experiment before you get this right. 詳細は the manual for patch を参照してください。

• configure と Wine をコンパイルするために make 、インストールするために sudo make install を実行してください。("make install" は任意であることに注意してください。Wine はビルドディレクトリら実行できます。)

See any of the many tutorials about building packages from source, e.g. http://www.tuxfiles.org/linuxhelp/softinstall.html or https://help.ubuntu.com/community/CompilingSoftware for more tips, or see the README file in the source tarball for more detailed instructions.

2.8. パッチを適用するには?

ソースから Wine をビルドする必要があります。上記を参照してください。

3. アプリケーションのインストール

3.1. 既に Windows にインストールされたアプリケーションがたくさんあるのですが、それらを Wine で動かすにはどうしたらいいですか?

短い答え: Wine でそれらを Windows でするのを同じように インストールする必要があります。多くのアプリケーションではセットアップ・インストーラプログラムがあります。

長い答え: Windows から Wine へコピーするだけで動くアプリケーションもありますが、いじるのが好きでない限り(直訳: あなたが車が走行中にボンネットの下をいじくり回すが好きでなければ)試さないでください。

Wine は存在している Windows 環境とやりとりするように設計されていません。Windows 環境に必要なデータがあるなら、Windows のファイルシステムを普通のファイルマネージャでブラウズし、他の場所へデータをコピーしてください。

WARNING: Do not try to configure Wine to point to your actual Windows C:\ drive. This will break Windows and require a Windows reinstall. We have tried to make this hard to do, so you probably cannot do it by accident. If you do manage this, Wine may or may not continue to operate, but your Windows install will be 100% dead due to critical parts of it being overwritten. The only way to fix Windows after this has happened is to reinstall it.

3.2. Wine を使ってインストーラを実行するには?

Windows でするのと同じようにインストーラをダブルクリックしてください

ファイルを開いた際に違うプログラムが起動する場合があります。もしそうなった場合、ファイルタイプの関連付けを確認してください。

右クリックで"アプリケーションで実行"を選択し、"Wine"を選択することでもできます。

それでも駄目なら、端末を開き、インストーラの '.exe' ファイルを含むフォルダへ " ディレクトリの変更(cd)"し、wine <installer_name> と入力し、インストーラを Wine で実行してください。例:

cd ~/Desktop
wine FluffyBunnySetup.exe

もし、インストーラの名前が .exe で終わってなければ、'wine start <filename> を使う必要があります:

cd ~/Desktop
wine start FluffyBunnySetup.msi

完全なパスやファイル名を入力する代わりに、最初の数文字だけを入力し、Tab キーを押すことでたいてい入力したいファイル名を補完してくれます。同じ文字から始まるファイルが複数存在する場合は、2度 Tab キーを押すことでマッチしたすべてのファイルを表示します。

プログラムが複数の CD-ROM ディクスに含まれる場合、インストーラを終了しない限りディスクを取り出せないので Wine を CD-ROM のディレクトリから起動したくないでしょう。まず winecfg の"ドライブ"タブで CD-ROM ドライブが割り当てられているドライブレターを確認してください(例: D: -> /media/cdrom)。そしてインストーラを以下の方法で実行してください:

wine start 'D:\setup.exe'

または

wine start /unix /media/cdrom/setup.exe

3.3. インストールしたアプリケーションを複数のユーザで共用するには?

Wine は複数の wineservers を同時に実行することによるレジストリの汚染 (bug 11112) という危険性のため、現在ユーザの間で configuration ("prefixes") を共有できません。現在、アプリケーションはユーザごとに分けてインストールしなければなりません。

しかしながら、Wine prefix をコピーすることができます。ひとつの prefix にすべてをインストールし、それぞれのユーザのホームディレクトリにそれをコピーしてください。これでインストーラを何度も実行する必要がなくなります。

3.4. Wine が Windows プログラムをインストールした時にシステムのファイルタイプの関連付けの変更やメニューやデスクトップのリンクの追加をしないようにするには?

インストーラがWindows アプリケーションのためにファイルタイプの関連付けやメニューへの追加やデスクトップにリンクを作成をするのが嫌な人は winemenubuilder.exe を無効にすることができます。それをするには以下のような複数の方法があります:

1. winecfg: インストーラの実行の前に、winecfg を実行し、ライブラリタブを開き、"ライブラリの新規オーバーライド欄に "winemenubuilder" と入力する(ドロップダウンリストにはありません)。追加をクリックし、"既存のオーバーライド"欄から選択する。"編集"を押し、リストの中から"無効"を選択し、"適用"をクリックする。

2. レジストリファイル: もし何度も設定を適用する (例: 毎回 Wine prefix を作り直す) なら、この方法はより便利なはずです。拡張子 .regを付けたテキストファイル (例: disable-winemenubuilder.reg) を作り、下記の内容を書き込んでください。

   [HKEY_CURRENT_USER\Software\Wine\DllOverrides]
   "winemenubuilder.exe"=""
   

   適用するには下記を実行:

   regedit disable-winemenubuilder.reg
   

3. "環境変数:" インストーラを実行する際に WINEDLLOVERRIDES 環境変数を設定する。例:

   WINEDLLOVERRIDES=winemenubuilder.exe=d wine setup.exe

winemenubuilder.exe の無効化は wine のプログラムがそれが見つからないというエラーを表示するかもしれません(このエラーはプログラムの処理を妨げるようには思えませんが)。エラー回避の代替方法として winemenubuilder.exe を何もしないプログラムに置き換える方法があります。wine 環境で MinGW gcc で以下をコンパイルして、C:\Windows\System32\winemenubuilder.exe に置いてください。:

#include <stdio.h>
int main()
{
/* Do nothing */
return 0;
}

そして winecfg で winemenubuilder.exe を "無効" とする代わりに "native" とする以外上記(1.)と同じ手順を実行してください。または以下のレジストリや環境変数を使ってください。

[HKEY_CURRENT_USER\Software\Wine\DllOverrides]
"winemenubuilder.exe"="native"

WINEDLLOVERRIDES=winemenubuilder.exe=n wine setup.exe

3.5. MSI ファイルを持っているのですが、どうすれば、インストール・実行できますか?

MSI ファイルは直接実行できず、msiexec プログラムを使う必要があります。MSI ファイルは端末から Wine に以下のようにしてインストールできます。

wine msiexec /i whatever.msi

または

wine start whatever.msi

上記の実行により Windows 環境で MSI プログラムをダブルクリックしたときのように実行できます。

3.6. Can I use Wine to install drivers for my hardware?

No. With the possible future exception of some printer drivers, Wine requires your hardware to already be working on your operating system. The technical reason for this is that Wine, like most applications, runs in user mode and not kernel mode.

3.7. My installer tells me I don't have enough free disk space

大抵、本当に十分な空きディスク容量がありません。Wine の C: ドライブはユーザのホームディレクトリにあります。どのパーティションに /home があってもプログラムのために十分な空き容量が必要です。以下の実行でチェックしてください。

df -h $HOME

もし必要な空き容量が 1 GB 以下で、df は 1 GB 以上利用可能と報告するなら、Windows バージョンを Windows 98 と設定してみましょう。これは大容量ドライブをうまく処理できない古い (Windows 98 時代) のインストーラへの対処法です。

If you want to use a different partition that has more free space, use a wineprefix that is located on the other partition. Note that your other partition must be a Unix filesystem; FAT and NTFS partitions will not work. See How can I run two programs as if they were on different computers for instructions.

4. アプリケーションの実行

4.1. 一度インストールしたアプリケーションを実行するには?

Wine にアプリケーションをインストールした後に、アプリケーション (Applications) → Wine → プログラム (Programs) のメニューのエントリや、Windows 環境下と同じようにデスクトップにアイコンがたぶんあるでしょう。それらは Windows 環境下でと同じように使うことができます。

代わりに、ホームディレクトリの .wine/drive_c/Program Files フォルダをブラウズし (これは隠しフォルダであるのでファイルマネージャで 表示 (View) → 隠しファイルの表示 (Show Hidden Files) を選択する必要がある) 、アプリケーションの中心的な .exe ファイル (推測する必要があるかもしれない) を探し、ダブルクリックしてください。

上記すべてがだめなら、 端末画面を開き、 アプリケーションのディレクトリに移動してください。例:

cd ~/.wine/drive_c/Program\ Files
ls
Adobe     Microsoft   FluffyBunny
cd FluffyBunny

そしてアプリケーションの中心的な .exe ファイル (推測する必要があるかもしれない) を探し、それを下記のように wine コマンドを使って実行してください。

ls *.exe
fluff.exe  uninstall.exe  ereg.exe
wine fluff.exe

4.2. プログラムにコマンドライン引数を渡したい

例えば Windows 上で次のプログラムを使っているなら:

quake.exe -map e1m1

Wine では、下記で同じことができます:

wine quake.exe -map e1m1

先頭の wine を除けば、コマンドラインは同じです。Linux シェルを使っているので、バックスラッシュで特殊な文字をエスケープする必要があるかもしれないので注意してください。例:

quake.exe -map C:\Quake\e1m1.bsp

は:

wine quake.exe -map C:\\Quake\\e1m1.bsp

バックスラッシュの使用について、さらなる情報は、http://www.tuxfiles.org/linuxhelp/weirdchars.html を参照してください。

4.3. コマンドラインから Windows プログラムを起動するにはどうするべきですか?

This will allow you to see messages from Wine that may help troubleshoot problems.

Because Windows programs will often look for files in the location they were started from, when using the command line you should start them in a very specific way: "change directory" to the folder where the program is located and run the .exe file using only its filename. For example:

cd '.wine/drive_c/Games/Tron'
wine tron.exe

In some cases you may wish to specify the full path to the program's .exe file. For example, if you need to install a program from multiple CDs, the previous method won't work (entering the directory in the terminal will prevent you from removing the CD). You can provide Wine with a DOS or Windows style path inside single quotes like so:

wine start 'C:\Games\Tron\tron.exe'

You need to use wine start if you specify a full path, because that allows Wine to set the working directory for the program if it needs it. You can also use double quotes, but you need two backslashes instead of one:

wine start "C:\\Games\\Tron\\tron.exe"

もし Unix スタイルのパス名を使う必要があるのであれば、/Unix オプションを使ってください。例:

wine start /Unix "$HOME/installers/TronSetup.exe"

現在の Wine では、一度プログラムをインストールしたら、インストーラが作ったどのショートカットも安全に使えます。

4.4. ファイルマネージャで .exe ファイルをダブルクリックしても何も起こりません

Note: If you can, start applications by clicking on the application's icon in the Applications / Wine menu or desktop instead. Double-clicking .exe files is typically only needed for applications that aren't installed yet, e.g. to run the setup.exe on a CD-ROM game or a downloaded installer.

もし、ダブルクリックで動かなかったら(例: 最近の Ubuntu)、ファイルを右クリックし、Wine で実行を選択する必要があります。これはファイルマネージャによって異なります。If that also doesn't work, contact whoever built your Wine packages and let them know there's a problem.

ファイルマネージャの代わりにコマンドラインを使うことで対処できます。(前の質問を参照) もし、以下のような行を見たら、

err:module:import_dll Library MFC42.DLL (which is needed by L"C:\\Program Files\\Yoyodyne\\Overthruster.DLL") not found

これは不足したランタイムライブラリをインストールする必要があることを意味します。"My application won't run, and says it needs MFC42.DLL" を参照してください。

5. アンインストール

5.1. Windows アプリケーションをアンインストールするには?

Wine の uninstaller コマンドを Windows の"プログラムの追加と削除"機能のように実行できます。これはメニューやデスクトップエントリを消すはずですが、よくテストされていません。すべてのアプリケーションで動かないかもしれません。確実にすべての Windows アプリケーションを消す方法は下記を参照してください。

5.2. すべての Windows アプリケーションをアンインストールするには?

Wine 環境下にインストールされたすべてのプログラムを削除するには、以下のコマンドを端末に貼り付けして Wine 環境 (たいてい ~/.wine ディレクトリ) を消してください:

rm -rf $HOME/.wine

ただ、システムメニューからは削除されないので、メニューから消すには端末に以下のコマンドを貼り付けしてください。

rm -f $HOME/.config/menus/applications-merged/wine*
rm -rf $HOME/.local/share/applications/wine
rm -f $HOME/.local/share/desktop-directories/wine*
rm -f $HOME/.local/share/icons/????_*.{xpm,png}
rm -f $HOME/.local/share/icons/*-x-wine-*.{xpm,png}

5.3. Wine をアンインストールするには?

Wine をディストリビューションのパッケージ管理システムでインストールしたなら、Wine をアンインストールするのにもう一度パッケージ管理システムを使ってください。(ソースから Wine をインストールしたなら、Wine を削除するにはソースのディレクトリで make uninstall を実行してください。)

上記は Windows アプリケーションをアンインストールしません。したければ、上記を参照してください。

6. トラブルシューティング

6.1. デバッグログを手に入れるには?

アプリケーションをコマンドラインから実行してください。(参照: コマンドラインから Windows プログラムを起動するにはどうするべきですか?)

短ければ、端末画面からログをコピーし、ファイルに貼り付けることができます。長ければ、wine の出力をファイルに Unix シェルリダイレクト を使ってリダイレクトしてください。例:

cd ~/.wine/drive_c/Games/Tron
wine tron.exe &> log.txt

より詳細なデバッグログを得るためには デバッグ・トレースを取得するには? を参照してください。

6.2. GUI クラッシュダイアログを無効にするには?

Wine 1.1.20 からデフォルトで GUI クラッシュダイアログが有効になっています。Users of apps that work despite a background crash may find the GUI dialog annoying, and in some cases the dialog itself has been reported to prevent an app from working.

クラッシュダイアログを無効にする最も簡単な方法は winetricks を使う方法です:

sh winetricks nocrashdialog

もし手動で設定したいなら、テキストエディタに以下のキーをコピーしてください。

[HKEY_CURRENT_USER\Software\Wine\WineDbg]
"ShowCrashDialog"=dword:00000000

.reg 拡張子を付けて (例: crashdialog.reg) 保存してください。regedit で適用してください:

regedit crashdialog.reg

(保存した場所によってはファイルのフルパスを指定する必要があるかもしれません。)

GUI クラッシュダイアログの設定を元に戻すには、00000000 を 00000001 に変更し、再適用してください。

これらの変更は regedit を実行し、適切なキーをポイント・アンド・クリック方式で追加・変更することでも可能です。

6.3. My program froze up, how do I close it?

端末から wine (program).exe としてプログラムを実行しているのであれば、端末画面に戻って Ctrl+C を押してください。ランチャーショートカットなど他の方法でアプリケーションを実行しているのであれば、端末を開き強制的に終了することができます:

killall -9 Application.exe

もし、すべての Wine プログラムを一度に終了するには、以下を実行してください:

wineserver -k

端末で wine taskmgr を実行することで Wine バージョンの Windows タスクマネージャを開けます。これは個別の Wine プロセスを終了できます。

6.4. My whole computer freezes or reboots when I run my game in Wine!

Wine を実行した後で完全に止まってしまったり、マウスの使用さえ出来なくなってしまうなら、たぶん Wine ソフトウェアに特有の問題ではないでしょう。Wine はユーザレベルのプロセスで、どんな環境でも OS を完全にハングアップさせることはできないはずです。Instead, Wine is likely exposing a deeper problem with the system, such as a defective hardware driver, a bad memory stick, or overclocking flakiness.

It's often a graphics driver problem, in which case non-Wine apps might also be affected. If running glxgears also crashes, it's definitely a graphics driver problem. The most common cause is upgrading to a new kernel without also updating the graphics drivers to match. Try reinstalling your graphics drivers.

If the computer is a laptop and shutting itself off entirely, a likely cause is overheating. Some laptops have problems with cooling to begin with, and the Linux ACPI code controlling fans is known to be buggy.

If that doesn't help, ask for help on the wine-users forum. Be sure to mention the name of the app, the version of wine, the output of cat /etc/issue , lspci | grep -i vga , and, if you're using the proprietary NVidia drivers, cat /proc/driver/nvidia/version . Maybe someone can help.

6.5. My application says some DLL or font is missing. What do I do?

Applications should come with all the DLLs they need (except for core Windows DLLs). They sometimes forget to, and rely on you to already have the DLL or font installed. You can install the missing DLL or font in several ways:

1. downloading them from the original creators of the runtime (eg. Microsoft). The easiest way to do this is with winetricks (see below).

2. installing other applications which do include them
3. copying them from a licensed version of Windows installed on the same machine

Do not download DLLs or scripts from websites you do not know and trust! Fake or infected DLLs can cause you great pain, even on Wine.

Missing DLLs that can be installed with winetricks include:

• MFC40.DLL and friends: run winetricks and select mfc40 (Microsoft Foundation Classes from Visual C++ 4).

• MFC42.DLL, MSVCP60.DLL and friends: run winetricks and select vcrun6 (MS Visual C++ 6 sp4 libraries: mfc42, msvcp60, msvcrt).

• MFC71.DLL, MSVCP71.DLL and friends: run winetricks and select vcrun2003 (MS Visual C++ 2003 libraries: mfc71,msvcp71,msvcr71).

• MFC80.DLL, MSVCP80.DLL and friends: run winetricks and select vcrun2005 (MS Visual C++ 2005 libraries: mfc80,msvcp80,msvcr80).

• MFC90.DLL, MSVCP90.DLL and friends: run winetricks and select vcrun2008 (MS Visual C++ 2008 libraries: mfc90,msvcp90,msvcr90).

• MDAC: run winetricks and select mdac27 (MS MDAC 2.7).

See the winetricks wiki page for a complete list of winetricks commands.

6.6. アプリケーションが実行できません。.NET が必要と表示されます。

Wine はまだ .NET に多くの問題があります。You may be out of luck, but if you're brave, you can still try running it.

winetricks を実行し、 dotnet20 を選択することにより .net 2.0 をインストールしてください。winetricks を実行し、 dotnet20 を選択することにより .net 2.0 をインストールしてください。これはまだあまりサポートされていませんが、動く .NET アプリケーションもあるでしょう。これらのランタイムのインストールに関するさらなる情報は .NET AppDB を参照してください。

または、オープンソースの .Net 2.0 実装の Mono を winetricks を実行し、 mono26 を選択することでインストールすることもできます。これはあまりサポートされておらず、実際、Wine で動く .NET アプリケーションはとても少ないです。さらなる情報は Mono Project AppDB を参照してください。

6.7. アプリケーションが実行できません。Internet Explorer が必要と表示されます。

Wine は Firefox のコア (Gecko と呼ばれる) を使い Wine の Internet Explorer を実装しています。

In some cases, you can make applications which think they need IE happier by running winetricks and selecting gecko and/or fakeie6. You can also try to install the real Internet Explorer using winetricks: see "How do I install Internet Explorer in Wine?" below.

6.8. My application runs, but text areas act strangely (e.g. lines don't wrap, double-clicking doesn't select words)

You may have run into a bug in Wine's RICHED20.DLL. You can try using Microsoft's RICHED20.DLL by running winetricks and selecting riched20. This may let you work around the problem until the Wine developers fix the bug.

6.9. My application doesn't run right, and the log says

6.9.1. Too many open files, ulimit -n probably needs to be increased

Your operating system is probably living in the past, and has too low a hard limit on the number of open file descriptors. (See https://bugs.launchpad.net/ubuntu/+bug/663090 for why raising the hard limit is the right thing to do, and why raising the soft limit by default is dangerous.)

For Ubuntu and most modern versions of Linux, you can do it like this:

Edit /etc/security/limits.conf as root, and change the line

* hard nofile 2048   (or whatever the current limit is)

to

 * hard nofile 8192

(The asterisk means 'for all users'.)

Then log out and log in again, and do  ulimit -H -n  It should show 8192 now, and Wine should have access to more file descriptors.

Here's another method that's more portable (might even work on Mac OS X), but only works temporarily, and only raises the limit for apps started from the current terminal window:

$ sudo bash
# ulimit -n 8192
# su yourusername
$ wine yourprogram.exe

6.9.2. ISSUE: "preloader: Warning: failed to reserve range 00000000-60000000"

または

6.9.3. winevdm: unable to exec '<APP NAME>': DOS memory range unavailable

この問題は bug 12516 に従ってください。

Linux カーネルの設定が原因です。root で cat /proc/sys/vm/mmap_min_addr を実行して、出力が0でなければ、root で sysctl -w vm.mmap_min_addr=0 を実行することで一時的に問題を直すことができます。永続的に直したいなら、/etc/sysctl.conf に vm.mmap_min_addr=0 という行を加えてください。Please record if you do this alteration, as the area Wine needs may change.

さらなる情報は PreloaderPageZeroProblem を参照してください。

6.9.4. Failed to use ICMP (network ping), this requires special permissions

On *NIX systems ICMP ping requires use of raw sockets, which is limited to super user (root) only. And running Wine as root is a bad idea. Fortunately newer versions of Linux allow granular permission control to grant only required permissions to specified files.

To allow Wine opening raw sockets run this command:

sudo setcap cap_net_raw+epi /usr/bin/wine-preloader

Note: This works with default binary Wine install only on most distros. Self-compiled Wine will be located under /usr/local/bin. The 64-Bit name is wine64-preloader. 3-rd party Wine wrappers (such as PlayOnLinux) might keep Wine binary in other places.

6.10. グラフィックス

6.10.1. My application complains about being unable to change the resolution or color depth.

You generally need to edit the Screen section of your /etc/X11/xorg.conf to support additional color depths and resolutions. There may also be a problem with Xrandr.

6.10.2. The application I am trying to run complains that it needs 256 colors but I have millions of colors.

The inability to switch from 24bpp mode to 8bpp mode is a limitation of X, not a bug in Wine. See 256ColorMode for some possible workarounds.

6.10.3. My X screen won't go back to its normal resolution after running a game fullscreen.

You can often work around this by changing the screen resolution and then changing it back again under the system preferences.

Alternately, you can run this terminal command to restore your X settings:

xrandr -s 0

6.10.4. I'm using Desktop Effects with Compiz, Fusion, or XGL and get poor performance/odd messages/broken applications

Using compositing managers in X11 tends to cripple OpenGL performance or break OpenGL entirely (this does not apply to the Mac OS X compositor, which cannot be disabled). We recommend that you disable them entirely before trying to use Wine. If you are using one and experiencing slow performance then please do not file bugs in Wine, as these are bugs in your window manager or your video drivers. Also, disabling the Composite extension within /etc/X11/xorg.conf will most certainly prevent any compositing from affecting Wine.

6.10.5. Graphics in games with good ratings in AppDB are scrambled.

• Check the game using the latest graphics drivers.

• Most AppDB entries are based on NVIDIA/GeForce hardware running the proprietary driver.

• ATI/AMD/Radeon cards running the proprietary fglrx driver have problems in Wine. As a rule of thumb, at least games that use shaders are broken. See this posting and Wine bug 7411 for details.

• Other hardware (Intel/S3/Matrox etc.) will probably run only old (non-shader) games. Compatibility is not well tested.

• Same for open source drivers as their 3D support is typically basic only.

6.10.6. Wine displays corrupted or missing text.

This may be bug 16146, caused by the nvidia-96xx legacy driver, or bug 18120, which affects QT 4.5.0 applications. It could also be caused by missing fonts, font conflicts, or adding new fonts to Wine.

Try using a fresh Wine prefix (by moving or deleting ~/.wine, or changing the $WINEPREFIX environment variable). If you still have this problem, try setting the following in the Wine registry:

[HKEY_CURRENT_USER\Software\Wine\X11 Driver]
"ClientSideWithRender"="N"

Place above in a text file called norender.txt and it can be inserted into the registry with the command regedit norender.txt. Please apply only as required. (This was reported as being required of OS X on the 1 Dec 2007, and more recently on other platforms, such as Ubuntu.)

6.10.7. Wine のウィンドウやフォントがとても大きく、winecfg ウィンドウが画面に収まらない。

Sometimes you can use the ALT key and the mouse to move the winecfg window so you can reach the "Screen Resolution" slider on the Graphics tab; slide it down. Changes will not effect the winecfg window until it's restarted.

If that doesn't work, you can use this one line registry change (all one line):

echo -e "[HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Hardware Profiles\\Current\\Software\\Fonts]\n\"LogPixels\"=dword:60\n" | wine regedit -

If all fails, you could remove your ~/.wine directory and reinstall your Windows applications.

6.11. サウンド

6.11.1. Wine で OSS を使っていますが、サウンドが鳴りません

Unless you're using a sound card with an emu10k1/2 chipset (SB Live!/Audigy) or another type of card that supports "hardware mixing" then you can only ever have one application using sound at the same time. If you have aRts (KDE sound system), ESD (Gnome sound system) or any music applications open then you simply won't hear anything from Wine. You need to kill or close all these programs before being able to get sound from Wine. To work out if anything has locked your sound-card already, you can do cat /dev/urandom >> /dev/dsp. If you get an error message it means that something is using it. If you get loud static this means that your sound card is clear and ready for use.

6.11.2. Running winecfg seems to hang or complain about files when I click the audio tab

The hang is caused by the NAS sound driver. This causes winecfg to pause for a while but it should respond eventually. The only way to get around this is to remove NAS from your system and/or build Wine without NAS support in the first place.

If you see messages about JACK in the terminal, they can be ignored unless you intend to use the JACK driver. If you wish to use the JACK driver, you need to install JACK's libraries onto your machine before JACK will work.

6.11.3. Audio in games sounds different from running in Windows

A number of DirectSound features are not implemented (correctly) in Wine yet.

• Sound effects (echo etc.) are not implemented (Bug 10603)

• Multi-channel surround audio is not implemented (Bug 11764)

• 3D sound positioning is not completely correct (Bug 11499)

• Doppler effect is not implemented (source)

6.11.4. MP3s do not play in Windows Media Player or applications that depend on it

For MP3 sound to play out of the box in apps that use the WMP engine and codecs, you must have 32-bit libmpg123 installed on your system and Wine must have been compiled with MP3 support. Not all distro packages provide this; openSUSE packages in particular are known to be compiled without MP3 support.

The workaround for lack of libmpg123 and/or winemp3.acm is to use the codec installed by WMP9, l3codeca.acm. Copy l3codeca.acm to the wineprefix's /windows/system32 directory (or use winetricks to install WMP9), then create a symlink to it named winemp3.acm in the same directory. Wine will then use the native codec to play MP3s.

This only affects WMP and apps that rely on it for MP3 playback (including Powerpoint). Apps that install their own MP3 codec, such as Winamp or VLC Player, should be able to play MP3s without this workaround.

6.12. CD・DVD ディスクを取り出せません

Try wine eject . It is a function to free up, unlock, and eject the drive. Make sure that the drive is mapped as a CD-ROM in winecfg and specify the drive letter in the command line, e.g.:

wine eject d:

6.13. My program fails to do networking, but my other applications can get online

Note: These instructions are for older Wine installs. If you're using Wine 1.x and your application still fails to do networking, you can give this a try as well. If you're running Wine 1.x and below instructions work for you, file a bug so we can fix Wine to improve other people's experience.

You need to make sure that your hostname resolves to the IP address of your network interface. To verify if you have this problem run hostname -i. If it returned IP address starting from "127." then read on.

To set this up correctly, you can type the following from a terminal:

hostname

This will return your hostname the way your computer sees it. Now, you need to open an editor with system administrator privileges, how you do this will depend on the distribution you are using. Open the file /etc/hosts and see if there is an entry for your hostname. Assuming your hostname is "yourhost" and your network IP address is 192.168.0.23, the entry might look like this:

127.0.0.1      yourhost.yourdomain.com      yourhost

Change this to (or add, if there is no such line):

192.168.0.23   yourhost.yourdomain.com      yourhost

For most Windows games with networking problems, this is all you need to get networking to work.

6.14. どうして64ビット OS では DNS 解決ができないのですか?

多くのディストリビューションではすべての wine の必要な32ビット互換ライブラリを提供していません。そのような場合、wine は 32ビット DNS ライブラリが必要です。Ubuntu・Debian では、そのパッケージは lib32nss-mdns です。それらの OS でインストールするには、以下を実行:

sudo apt-get install lib32nss-mdns

ほかの OS ではパッケージ名やインストール方法は異なるでしょう。ディストリビューションのサポート媒体を参照してください。

6.15. Wine のメニューを消してしまい元に戻せなくなってしまいました

Rather than actually delete anything, menu editors on Unix desktops simply mark menu entries as hidden so that they don't show up in the menu. Thus, they remain hidden after reinstalling the application. First, see if these menu entries can be found your menu editor and re-enabled.

This information is stored in ~/.config/menus/applications.menu . Edit ~/.config/menus/applications.menu and you should find a section near the end that looks similar to this:

        <Menu>
                <Name>wine-wine</Name>
                <Deleted/>
        </Menu>

or perhaps this:

        <Menu>
                <Name>wine-wine</Name>
                <Menu>
                        <Name>wine-Programs</Name>
                        <Menu>
                                <Name>wine-Programs-AutoHotkey</Name>
                                <DirectoryDir>/home/user/.local/share/desktop-directories</DirectoryDir>
                        </Menu>
                </Menu>
                <Deleted/>
        </Menu>

<Deleted/> の行を消すと、Wine のメニューは復活するでしょう。

6.16. アプリケーションのいくつかのキーコンビネーションが動作しません

Even in full screen mode, window managers typically capture some keys. For example, in KDE and GNOME, Alt+Left Click is used to move the whole application window by default. Thus, this key combination is not available to applications in Wine. You have to disable the colliding combinations in your window manager. For KDE, see Control Center/Window Behaviour or (better) Window-specific settings/Workarounds/Block global shortcuts. For GNOME, see System/Preferences/Windows and change the "Movement Key" setting. Also see System/Preferences/Keyboard Shortcuts for specific keyboard combinations.

(Keywords: Keyboard, Shortcut, Modifier, Alt, Ctrl, Control.)

6.17. さらに詳しいヘルプはどこで手に入れられますか?

この wiki に加えて、Wine HQ ドキュメントやメーリングリストなどで詳しいヘルプを得ることが出来ます。wine-users メーリングリストはフォーラムのインターフェイスも兼ね備えており、利用する可能性が最も高いでしょう。また、ソフトウェアの開発者で Winelib を使ってアプリケーションを移植することを目指しているのなら、 wine-devel メーリングリストを使うことにも挑戦してみてください。

特定のアプリケーションについてのヘルプは、アプリケーションデータベースで探してみてください。ここでは、ユーザーから送られたテストデータ、ヒント、コツなどの経験談を共有することが出来たり、質問を行うことが出来ます。

IRC チャンネル: #WineHQ on irc.freenode.net. ここでは、知識がある Wine ユーザと合うことが出来ます。また、たまに開発者が潜んでいることがあります。より重要な情報は IRC を参照してください。

6.18. I think I've found a bug. How do I report this bug to the Wine programming team?

Bug reports should be submitted to our online Bugzilla system (http://bugs.winehq.org/). To increase developer productivity and facilitate a resolution to submitted bugs, please read the Wiki article on Bugs. A poor bug report may be marked INVALID and closed, leaving you no closer to resolving your problem. High quality bug reports are an essential part of making Wine better.

Please note that you should generally avoid submitting bug reports if you have used any third party applications or native DLL overrides.

7. Wine の使い方

7.1. How do I wipe the virtual Windows installation?

You can remove your virtual Windows installation and start from scratch by either removing the hidden .wine directory in your home folder.

Please note that in the following commands there should be no spaces in the path, particularly between $HOME/ and .whatever.

rm -rf $HOME/.wine

or renaming it (in case you want to keep it for a backup):

mv $HOME/.wine $HOME/.wine-old

This will leave dangling MIME entries and desktop entries in ~/.local/share. To remove these, see How do I uninstall Windows applications? Alternatively, you can stop Wine from creating them in the first place.

7.2. Can I store the virtual Windows installation somewhere other than ~/.wine?

Yes: ~/.wine is just the default Wine "prefix" (a.k.a. "configuration directory" or "bottle").

You can change which prefix Wine uses by changing the WINEPREFIX environment variable (outside Wine). To do this, run something like the following in a terminal:

export WINEPREFIX=~/.wine-new
wine winecfg

Wine will then create a new prefix in ~/.wine-new.

To use the default prefix, use the command unset WINEPREFIX . Or just set WINEPREFIX to ~/.wine.

You can rename, move, copy and delete prefixes without affecting others, and each prefix has its own wineserver instance.

Wherever you see "~/.wine" or "$HOME/.wine" in this Wiki, you can usually replace it with "$WINEPREFIX".

7.3. How can I run two programs as if they were on different computers?

Example: You have server and client programs. One won't run in the presence of the other.

Using different Wine prefixes will help you here, since they simulate two Windows computers, in essence.

最初のプログラムは普通に起動してください。

wine first-program.exe

2 つめのプログラムは別の prefix で実行する必要があり、環境変数 WINEPREFIX を変更する必要があります。

WINEPREFIX="$HOME/.wine-second" wine second-program.exe

The first-program.exe and second-program.exe can be two copies of the same program.

7.4. Windows アプリケーションで文書を開いた時に native アプリケーションが起動するようにしたい

フルパスで指定したり、シェルを使った場合にのみ、Wine から直接 native アプリケーションを起動できます:

/usr/bin/glxgears
# または
/bin/sh -c glxgears

ファイル名を Windows 形式から Linux 形式へ変換するのに winepath を使う必要があるかもしれません。(次の項目を参照してください。)

7.5. I want to associate a native Linux program with a file type in Wine

ファイルタイプと native アプリケーションを関連付けるための方法は2つあります。1つ目は winebrowser を使う方法で、もう1つはシェルスクリプトを書く方法です。

以下の例は winebrowser をシステムのデフォルトの PDF ハンドラ (Unix なら xdg-open) を起動するために使います。以下を pdf.reg ファイルとして保存してください。

[HKEY_CLASSES_ROOT\.pdf]
@="PDFfile"
"Content Type"="application/pdf"
[HKEY_CLASSES_ROOT\PDFfile\Shell\Open\command]
@="winebrowser \"%1\""

'regedit $HOME/pdf.reg' コマンドを使って .reg ファイルをレジストリにインポートしてください。

もう一つの選択肢は native アプリケーションを実行するのにシェルスクリプトを使う方法です。以下を $HOME/bin に run_linux_program として保存してください。

#!/bin/sh
$1 "`wine winepath -u "$2"`"

実行可能にするために 'chmod a+x $HOME/bin/run_linx_program' を実行するのを忘れないでください。また $PATH に $HOME/bin が含まれていることを確認してください。そうでなければ動きません。

.pdf ファイルを Linux のプログラム acroread に関連付けるには以下を $HOME/pdf.reg として保存し、コマンド regedit $HOME/pdf.reg を実行してインポートしてください。

[HKEY_CLASSES_ROOT\.pdf]
@="PDFfile"
"Content Type"="application/pdf"
[HKEY_CLASSES_ROOT\PDFfile\Shell\Open\command]
@="/bin/sh run_linx_program acroread \"%1\""

レジストリファイルを編集するのにこのスクリプトを使い回すことができます。以下の例は .doc 文書を OpenOffice (ooffice) に関連付けるものです:

[HKEY_CLASSES_ROOT\.doc]
@="DOCfile"
"Content Type"="application/msword"
[HKEY_CLASSES_ROOT\DOCfile\Shell\Open\command]
@="/bin/sh run_linx_program ooffice \"%1\""

7.6. "winetricks" とは何ですか? どこで手に入りますか?

winetricks is a shell script that downloads missing DLLs and fonts for you from the best known source. It was written to help Wine developers, but it turned out to be useful for end users, too. See the wiki page about winetricks for more info.

7.7. Internet Explorer を Wine にインストールするには?

If you just want an application to think you have IE installed, see My application won't run, and says it needs Internet Explorer above.

The Wine project does not support installing the real Internet Explorer, as it requires a huge number of native DLLs, which is hard to configure.

If you really need the real IE use winetricks. Set your fake Windows version to win2k and then select 'ie6' or 'ie7'. IE installed from winetricks is far from fully functional, but works well enough to, e.g., test web page rendering. Please do not ask the Wine project for help if you run in to problems.

You should put IE in a separate wineprefix, with whatever app really needs it.

+You may also try commercial solutions, such as CrossOver and Bordeaux, but if you do so and run into problems, do not seek help on the forum/mailing list or IRC, as third party applications such as these are not supported here.

7.8. Wine が仮想デスクトップでアプリケーションを起動するようにするには?

それは winecfg で出来ます。アプリケーションタブにそのアプリケーションを追加し、画面タブで "仮想デスクトップをエミュレートする"を有効にしてください。

以下のコマンドを使うこともできます。(wine-0.9.60 以前では、これが唯一可能な方法です。)

wine explorer /desktop=name,1024x768 program.exe

program.exe を実行したいプログラムの名前に置き換えて、解像度を任意の仮想デスクトップのサイズに置き換えてください。name を変えることで同時に複数のデスクトップを開くことができます。

7.9. Wine のバージョンを知るには?

端末を開き、wine --version を実行してください。"wine-1.1.25" のように表示されるでしょう。もし Git を使っているなら、"wine-1.1.25-311-g3d6bb38" のように表示されるでしょう。

TIP: You can find out what the latest release of Wine is from WineHQ's main page. Currently, Wine development releases come out every two weeks. Your operating system may ship with an out of date (obsolete) version of Wine. Depending on what OS you use, you may be able to add an update source to your package management system to keep up to date. Check the downloads page for details.

7.10. Wine のバージョンの付番方式はどのようになっているのですか?

それぞれのバージョンの Wine は以下の形式のリリースタグを持っています。:

• wine-x.y.z

これは Wine のバージョン x.y.z を表わします。(タグのリスト)

• x はメジャーバージョン番号です。This has changed precisely once since the current version numbering system was introduced, and is unlikely to change for a while.

• y はマイナーバージョン番号です。数年ごとに変わります。If y is even, then this is a "stable" version: later releases are unlikely to break much. If y is odd, then this is a "development" version: later releases may cause regressions.

• z はリリース番号です。開発版リリースのために2週間ごとに増えています。安定版リリースのために数ヶ月ごとに変わります。

If you are using Git, the tag will be generated by the git-describe command, and looks like:

• wine-x.y.z-n-gccccccc

Where n is the number of patches/commits applied since x.y.z was released, and ccccccc is the first few hex digits of the most recent commit's id. Examples: wine-1.1.19-228-g1e256e4, wine-1.1.25-311-g3d6bb38, wine-1.1.32-584-g10b0b86.

Just before a stable release of Wine, there are so-called "release candidates", which have tags of the form:

• wine-x.y-rcn

Which is the nth release candidate for Wine x.y.

例:

7.11. Wine を root で実行するべきですか?

絶対に root で Wine を実行しないでください。それをするとWindows プログラム (とウイルス) がコンピュータやすべての取り付けられたメディアへの完全なアクセスをできるようになります。Running with sudo also has these same risks but with the added bonus of breaking the permissions on your ~/.wine folder in the process. If you have run Wine with sudo you need to fix the permission errors as described in the next question, and then run winecfg to set Wine up again. You should always run Wine as the normal user you use to login.

Linux システムでは、 Wine が root を必要とすることは POSIX ケーパビリティ (http://www.linuxjournal.com/article/5737) や POSIX ファイル・ケーパビリティ (http://www.ibm.com/developerworks/library/l-posixcap.html) や他のセキュリティ設定を修正することを通じて解決できます。

As far as Windows programs are concerned, you are running with administrator privileges. If an application complains about a lack of administrator privileges, file a bug; running Wine as root probably won't help.

7.12. wine を sudo や root として実行してしまいました。パーミッションエラーを直すにはどうすればいいですか?

You need to fix the permissions on your ~/.wine directory, this is where all Wine state, configuration and any important data you might have such as installed programs, saved data within Wine programs, etc. are stored. Once you delete or fix the permssions on this directory, rerun Wine as a regular user always! Run the following to fix the permissions on your ~/.wine directory if it now has root permissions.

cd ~
sudo chown -R $USER:$USER .wine

7.13. winecfg でどのサウンドドライバを選択するべきですか?

As of Wine 0.9.47 you shouldn't need to configure it any more, defaults should work just fine. For Wine 0.9.46 ALSA and OSS should work equally well. For Wine versions before 0.9.42 OSS works best, after that ALSA is slightly behind OSS since it might miss some voice chat capability.

7.14. どうして PulseAudio は利用可能でないのですか?

The Wine project has decided not to pursue a Pulse driver for Wine at this time. We feel it is best to keep working on the more mature Wine ALSA driver. We are aware that some distributions use Pulse as the default, and this is unfortunate. PulseAudio is also known to be buggy when emulating ALSA/OSS and should be disabled when using Wine.

非公式の Wine 用の PulseAudio ドライバがありますが、サポートされていません。それを使っている間のバグ報告を提出しないでください。Bug tracking this issue: bug 10495.

7.15. Wine のフォントにアンチエイリアスを適用するには?

Wine 1.1.12 からサブピクセルフォントレンダリングのサポートが追加されましたが、無効になっているかもしれません。winetricks を使い、fontsmooth-gray, fontsmooth-rgb, fontsmooth-bgr オプションの中の一つを選択してください。

Bugs tracking these issues: bug 10342 and bug 16729.

7.16. DPI (フォントサイズ) を変更するには?

まず、winecfg での設定を試してくささい。画面 (Graphics) タブを開き、スクリーン解像度を適切な値にスライドしてください。変更は winecfg を再起動するまで winecfg ウィンドウに影響しません。

もし、ウィンドウとフォントが大きすぎて winecfg でコントロールできなければ、"Wine のウィンドウやフォントがとても大きく、winecfg ウィンドウが画面に収まらない" を参照してください。

7.17. Wine のレジストリを編集するには?

Wine のレジストリは ~/.wine に .reg ファイルとして保管されますが、使われているエンコーディングのためこれらのファイルを手動で編集するべきではありません。常にWine に付属するregeditプログラムを使ってください。これは端末で regedit と入力することにより実行できます。Wine のレジストリは Windows バージョンのレジストリとほとんど等しく、レジストリファイルのインポート・エクスポートをサポートしています。Wine が壊れるので、Windows のレジストリすべてをインポートしようとしないでください。

参照: UsefulRegistryKeys

7.18. プロキシの設定をするには?

If you want to use a proxy server for all HTTP connections, simply set the http_proxy environment variable. On many Linux distributions, configuring a network proxy, e.g. with the Network Proxy tool, does this for you automatically.

Alternatively, you can configure a proxy in the registry. There are separate locations for wininet.dll and winhttp.dll.

For wininet, use regedit to add the following values to the [HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings] key:

"ProxyEnable"=dword:00000001
"ProxyServer"="proxy-server-address:port"

At present, Wine's wininet.dll does not support proxy autoconfiguration (PAC) scripts.

For winhttp, you'll need to use the proxycfg.exe utility to configure the registry. This utility is available in the system32 directory of a Windows installation, and MSDN describes its usage.

7.19. デバッグ・トレースを取得するには?

バグ報告をするとき、たいていトレースを取ることが必要です。(一般的に +relay,+seh ですが、デバッグチャンネル に詳細を尋ねてもよいかもしれません)トレースを得るには、以下を実行してください:

WINEDEBUG=+relay,+seh,+tid wine your_program.exe &> /tmp/output.txt

Then attach /tmp/output.txt to the bug. If the resulting file is larger than 1 MB, compress it with bzip2 or rzip -9 before attaching. There are some cases where the bug seems to disappear when WINEDEBUG is used with the right channel. Please mention that in the bug report. For a list of debug channels that are available in Wine, see DebugChannels

7.20. どのアプリケーションやサービスが Wine と衝突しますか?

Many distributions are moving towards enabling Compiz/Beryl/other eye candy by default. The problem is that these programs conflict with Wine over the display driver. Disable these programs before using any Wine applications (especially games, or when noticing weird window problems). Also, disabling the Composite extension in /etc/X11/xorg.conf will most certainly prevent compositing from affecting Wine.

Pulseaudio is also known to be buggy when emulating Alsa/OSS and conflicts with Wine.

Keyboard switching tools such as xneur (gxneur, kxneur) and SCIM have been reported to conflict with keyboard input in Wine.

8. アプリケーション

8.1. Wine は DirectX をサポートしていますか? Wine に Microsoft の DirectX をインストールできますか?

Wine は DirectX 実装を提供していて、いくつかのバグが残っていますが、うまく動くはずです。Wine は現在 DirectX 9.0c をサポートしています。DirectX 10 の実装は進行中です。

もし Microsoft の DirectX をインストールしようとすると問題が発生するでしょう。これを試してみることは Wine HQ は推奨しないしサポートしません。ランタイムをインストールすることはできますが、動かないでしょう。ランタイムは Windows のドライバにアクセスできる必要がありますが、Wine は明らかな理由でドライバにアクセスできません。The only native Microsoft DLLs that could be useful anyway are the d3dx9_xx.dll type ones, and these require you to accept Microsoft's license. Additionally, versions of these DLLs are now part of the Wine tree. So, as Wine improves these DLLs will only become less relevant.

そうは言っても、ガイドによっては Microsoft の DirectX のインストール方法を説明しています。繰り返しますが、これを試してみることは Wine HQ は推奨しないし、サポートしません。その上、Wine HQ のサポートメディア(フォーラムなど)ではオフトピックとみなしています。Please use a clean Wine configuration folder before seeking help. (You may need to rm -rf ~/.wine and re-install your Windows applications.)

8.2. How come Wine doesn't work well with copy protection?

コピープロテクトはディスクが"本物"かどうか検出するため様々な"汚い"方法を使います。 Some of these methods work in Wine but most do not, such as the extremely invasive StarForce system. Wine would need to be altered to allow for almost rootkit-like functionality of programs to get some of these copy protection schemes to work, so support is likely to be a long time off if ever. (Some people use illegally modified or "cracked" games with the copy protection removed, but the Wine project cannot advocate that.)

See also our page on copy protection.

8.3. ウェブサイトで見つけた howto に従ったのですが、アプリケーションは動きません

ブログやフォーラムに投稿された様々なアプリケーションに対する多くの非公式 howto があります。Wine の開発のペースが速いので、内容が投稿された時点で正しくてもすぐに時代遅れになるので、それらが作者によって維持されていることは稀です。Applying tweaks that are no longer needed in current Wine can actually prevent an app that now runs fine without tweaks from working at all (Office 2007 is a prime example). The only howtos supported here are the ones on this site. If you insist on following an outside one, ask its author for help.

疑わしいならば、もう一度、新規の wineprefix でアプリケーションをインストールし、ユーザフォーラムで質問してださい。

8.4. I used a third party application (PlayOnLinux, WineBottler, etc.) to install or manage applications in Wine and need help.

Consult the support channels for whatever third party application you used. Links to some of these outside applications are provided as a convenience on the Third Party Applications page, but they are not supported here. Before seeking help on the forum/mailing list/IRC or filing bugs, reinstall your Windows application using plain Wine.

8.5. 古いバージョンの Wine では動いていたアプリケーションが現在のバージョンの Wine では動きません!

それらは regression (退行) と呼ばれます。Please perform a regression test to identify which patch caused the regression, then file a bug report and add the regression keyword - we'll pay special attention to it, since they're a lot easier to fix when caught early.

8.6. I really need this particular application to work. How can I go about making this happen?

We're glad you asked. Please see our Helping Wine page for some suggestions.

Briefly, you can improve Wine yourself, convince someone else to do it for you, or try some complicated hacks involving native Windows DLLs rather than Wine's unfinished ones.

8.7. 私は Windows アプリケーションを書いています。Wine で実行されていることはどうすれば検出できますか?

それは悪い考えです。Developer FAQ を参照してください。

9. パフォーマンス

9.1. What are the system requirements for Wine?

The rule of thumb is that if your application runs fine in Windows, it should run fine on the same system using Wine. Wine, along with the operating system you use to run it, generally requires less disk space and memory than Windows itself. If you're not currently running a Windows application, Wine won't consume any resources at all other than about 20 megabytes of disk space.

9.2. 3D アプリケーション・ゲームがとても遅い。(fps)

大抵 3D のパフォーマンスの問題は、 OpenGL 3D ドライバの不具合を示しています。さらなる情報は 3DDriverIssues を参照してください。

9.3. Wine は Windows で使うより遅い?

実際、Wine のほうが速いこともあります。The speed of an application depends on a lot of factors: the available hardware and their drivers, the quality of the code in the APIs the application uses, and the quality of the code in the underlying operating system.

ドライバのコードはとても問題になります。グラフィックスの重いアプリケーションを Linux 上で ATI カードのような貧弱なドライバのビデオカードで使っているなら、実質的にパフォーマンスは下がるでしょう。他方、Linux はメモリ管理に優れていますし、多くの CPU 関連のタスクで Windows より速いという結果になるでしょう。さらなる情報はベンチマークを参照してください。

時々 Wine のバグによってアプリケーションが極端に遅くなることがありえます。Performance と Performance-related bugs を参照してください。

とは言うものの、Wine は正確に動くことが1番で、パフォーマンスは2番です。

9.4. 端末にたくさんの "fixme:" メッセージが表示され、Wine の実行が少し遅い

無視してください。一般的に、 fixme メッセージは Wine の開発に関係のない人にはあまり役に立たないでしょう。それらは Wine 開発者のためのものです。また、 fixme メッセージはたいてい深刻な問題を示しているのではないということを理解することは重要です。多くのアプリケーションはたとえ Wine がいくつかの fixme メッセージを表示したとしても普通に動きます。 That said, they can still sometimes provide insight into how a particular application works (or doesn't work).

If there are a very large number of these messages scrolling repeatedly, you can sometimes speed Wine up a little by turning them off altogether. You can do so by setting the WINEDEBUG environment variable to -all. For example, your command line could look something like:

WINEDEBUG=-all wine program.exe

More advanced users and programmers interested in debugging Wine should see DebugChannels and the Developer Documentation wiki pages. Here's an example to selectively turn off fixme messages from dsound and part of D3D only:

WINEDEBUG=fixme-dsound,fixme-d3d_surface wine program.exe

10. 危険性

10.1. Wine はマルウェア互換です

Windows でない OS の Wine で実行するというだけでウイルス、トロイの木馬、その他マルウェアから守られるという訳ではありません。

自分自身を守るためのいくつかの方法があります:

1. 信用できないサイトからの実行ファイルを実行しない。感染が起ったことがあります。

2. Web ブラウザやメールクライアントでは、理解や信用できない URL へのリンクを疑う。

3. いかなる GUI アプリケーション (Wine アプリケーションを含む) を root として実行しない。(上記参照)

4. ウイルススキャナを使う。例えば ClamAV は感染を心配するなら使うのを考慮してもよいフリーのウイルススキャナです。Ubuntu's notes on how to use ClamAV を参照してください。100% 効果的なウイルススキャナはありあせん。

5. Consider removing the default Wine Z: drive, which maps to the unix root directory. This is only a weak defense, but it might help against some attacks. The downside to this is you won't be able to run Windows applications that aren't reachable from a Wine drive (like C: or D:). This includes inability to install Wine-gecko (see bug 19873). A work around is to copy/move/symlink downloaded installers to ~/.wine/drive_c before you can run them.

6. If you're running applications that you suspect to be infected, run them as their own Linux user or in a virtual machine. (The ZeroWine malware analyzer works this way.)

10.2. How good is Wine at sandboxing Windows apps?

Wine はいかなる方法のサンドボックスをもまったく持っていません。 When run under Wine, a Windows app can do anything your user can. Wine does not (and cannot) stop a Windows app directly calling native syscalls, messing with your files, altering your startup scripts, or doing other nasty things.

Windows アプリケーションをサンドボックスで適切に守りたいなら、AppArmor や SELinux、 仮想マシンの一種を使ってください。

That said, winetricks does have a sandbox verb that does at least a partial job of isolating Wine programs from the rest of your system. It protects against errors rather than malice. It's useful for, e.g., keeping games from saving their settings in random subdirectories of your home directory.

10.3. ごみ箱を空にした時に、Nautilus はホームディレクトリを消すことがあります!

In some versions of Gnome (2.21.90?), if you move ~/.wine to trash, and empty the trash, everything that you can write to in your root filesystem is then deleted (including the contents of your home folder).

This is said to be fixed in Gnome 2.21.92. See https://bugs.launchpad.net/ubuntu/+source/nautilus/+bug/188361 and https://bugs.launchpad.net/ubuntu/+source/gnome-applets/+bug/195207

If you are logged in as root, this bug is worse, it can delete your entire hard drive.