Readme (UTF-8, ff=mac)
9/29/2013

The following Wiki might be helpful.
下面的Wiki也许可以帮上忙。
http://sakuradite.com/wiki/vnr/mac
http://sakuradite.com/wiki/vnr/linux

I only tested VNR on my MacBook, but I believe it would work on Linux as well.
Some screen shots are as follows:

Normal window with manual/machine/online translations
http://sakuradite.com/images/screenshots/mac1.jpg

Full screen mode and EPWING
http://sakuradite.com/images/screenshots/mac2.jpg

Preferences and text settings
http://sakuradite.com/images/screenshots/mac3.jpg

Shared dictionary and manual translation
http://sakuradite.com/images/screenshots/mac4.jpg

SpringBoard and game information
http://sakuradite.com/images/screenshots/mac5.jpg

Currently, support for Wine on Mac is at primitive stage.
I am not sure if I should put the entire VNR on wine, or to put wine on native Python/Qt
in the future. And I don't know exactly which features are broken on wine.
If you are interested, you could try getting wine and run VNR on it.
Following is a summary of working/broken functionalities that I tested on Mac OS X 10.8.5
using Wine 1.7.

Note: The latest VNR does not require anything to be installed using wine tricks.
But if you want, you could install following libraries, which are optional:
       winetricks vcrun2008
       winetricks vcrun2010
       winetricks d3dx9
       winetricks flash shockwave

+ Tested games that work out of box
  - CROSS CHANNEL (English version)
  - ChuSinGura47+1
  - レミニセンス
  - ハピメア

+ Features that work out-of-box
  - General hooks ending with A or W, game engines, and /H code
  - Online machine translation such as Baidu
  - Offline translators like JBeijing
  - Offline TTS using VOICEROID+ such as 結月ゆかり
  - Manual subtitles and comments
  - Shared database of game profiles
  - Shared dictionary
  - MeCab, EDICT, and EPWING
  - Flashy GUI including Growl, SpringBoard and GameBoard
  - Translate window text and menu
  - Game wizard and game detection
  - Locale changing
    Wine could be launched with Japanese locale
    Apps including AppLocale or NTLEA are not needed and are disabled
  - Software Update
    You can launch the update through Library/Update (Mac).sh

+ Features that partially work with issues
  - Full screen mode
    Stretching game window works out-of-box.
    But changing screen resolution does not work well.

+ Broken features
  - Offline TTS using SAPI such as VoiceText Misaki
  - Looking up Microsoft Japanese IME's dictionary
  - Drag-drop game to SpringBoard

+ Crash
  - Injecting game might crash it
  - Closing VNR before closing game might crash the game
    You might have to close the game before closing VNR.

You will need Wine and some knowledge of unix command line to set up VNR on Mac.
I am not sure if I should package and distribute pre-configured Wine binary.
Wine is kind of too large to distribute (up to 1GB), and it might violate copyright
if I distribute Microsoft binaries together like d3dx.
I think I might write some scripts to simplify installing VNR for Mac in the future.
Currently, here's what I did to make VNR work on Wine manually.

1. Get Wine from either Darwine or MacPorts
   Option 1:
   - Download Darwine from: http://sourceforge.net/projects/darwine/
   - You don't have to install Wine, which is be broken anyway.
     Just drag-drop Wine.app to your /Applications folder.
        You can find Wine.app in a HIDDEN folder in the downloaded Darwine dmg
   Option 2:
   - Install Xcode from AppStore
   - Install MacPorts from http://www.macports.org/
   - Execute: port install wine

2. Installing windows fronts // 安装Windows的字体
   Copy fonts from you Windows/Fonts to ~/.wine/driver_c/windows/fonts

3. Get VNR from http://sakuradite.org/reader.7z
  Then, you can launch "Library/VNR for Mac.app"
  Or manually execute following commands:
     export LC_ALL=ja_JP.UTF-8
     wine "Visual Novel Reader.exe"

If you have got questions or issues or suggestions, feel free to let me know!

= CHINESE =

VNR可以在Wine上运行了。Mac上的一些截图如下：

一般窗口，翻译来自人工字幕、百度和JBeijing
http://sakuradite.com/images/screenshots/mac1.jpg

全屏模式和EPWING辞书
http://sakuradite.com/images/screenshots/mac2.jpg

使用偏好和文本设定
http://sakuradite.com/images/screenshots/mac3.jpg

共享辞书和人工翻译
http://sakuradite.com/images/screenshots/mac4.jpg

SpringBoard和游戏情报
http://sakuradite.com/images/screenshots/mac5.jpg

现在，VNR对Mac的支持还很不稳定。一些功能可以工作，一些不能。
如果你很希望能在Mac上使用，那么也许可以下载下Wine，然后把你在Windows下的VNR呀
JBeijng呀游戏呀什么的拷贝到Mac上就好了呢。

注：最新版的Mac并不需要从winetricks安装任何东西。
如果你愿意，可以考虑通过winetricks安装下面这些库。反正这些都不是必需的。
       winetricks vcrun2008
       winetricks vcrun2010
       winetricks d3dx9
       winetricks flash

下面是我在Mac OS X 10.8.5上用Wine 1.7测试的可以和暂时不可以工作的功能。
+ 测试可以正常工作的游戏
  - CROSS CHANNEL (English version)
  - ChuSinGura47+1
  - レミニセンス
  - ハピメア

+ 正常工作的功能
  - 文本提取、游戏引擎和特殊码
  - 在线翻译比如Baidu
  - 离线翻译比如JBeijing
  - 离线VOICEROID+ TTS比如結月ゆかり
  - 人工翻译和弹幕
  - 共享的游戏设定数据
  - 共享辞书
  - 日文分词和EPWING辞书
  - VNR的全部图形界面
  - 翻译窗口文本
  - 游戏向导和游戏侦测
  - 更改日文编码
    其实Wine是可以直接用日文编码打开的。
    AppLocale呀NTLEA什么的都不需要了。VNR在Mac上会自动隐藏这些选项。
  - 软件更新
    你可以通过Library/Update (Mac).sh来打开更新程序。

+ 部分工作的功能
  - 全屏模式
    拉伸窗口实现全屏可以工作。改变分辨率全屏不能正常工作。

+ 暂时无法工作的功能
  - 离线SAPI TTS比如VoiceText Misaki
  - 查询微软日文输入法的辞书
  - 拖动游戏到SpringBoard来添加游戏

+ 崩溃的问题
  - 打开游戏时，ITH有时会让游戏崩溃
  - 先关闭VNR，再关闭游戏可能会让游戏崩溃。
    暂时只好先关闭游戏，再关闭VNR，就不会出现崩溃的问题了。

在Mac下使用VNR需要Wine和一些Unix命令行的知识。暂时只能手工完成。步骤如下：

1. 从Darwine或者MacPorts得到Wine
   选项1：
     - 从这里下载Darwine: http://sourceforge.net/projects/darwine/
     - 打开下载的dmg文件，在其中的一个*隐藏文件夹*中可以找到Wine.app。
       直接把Wine.app拖动到/Applications下就好了
   选项2：
     - 从AppStore安装Xcode
     - 从这里安装MacPorts：http://www.macports.org/
     - 执行如下命令安装wine
           port install wine

2. 安装Windows的字体
   把你的Windows7或者XP中的Windows/Fonts复制到~/.wine/driver_c/windows/fonts

3. 下载VNR：http://sakuradite.org/reader.7z
   之后，执行"Library/VNR for Mac (pre-alpha).sh"就好了。
   或者，也可以这样手动打开VNR：
       export LC_ALL=ja_JP.UTF-8
       wine "Visual Novel Reader.exe"

EOF

