Since so many have problems getting Apertium to run on Windows or OS X, or are limited in bandwidth, Tino Didriksen has put together a ready-to-use VirtualBox VDI:
- 520655120 bytes (496 MB)
- SHA-1: 15f31b43186b85848dbd71a90b0acf234339a29e
...or if you prefer a ZIP file:
- 817773930 bytes (779 MB)
- SHA-1: eb4f6f29de488a2ba398de1c9947d67ef1e93854
The archive decompresses to a 2.96 GB vdi file.
Important: If you just want to translate, you do not need the VirtualBox image. You can instead use the much smaller Apertium Simpleton UI.
- Debian Sid, trimmed of all non-essential packages
- VirtualBox Guest Additions
- XChat, set to automatically connect to Freenode #apertium as nick ap-vbox (appending -2 or -3 on conflict), preconfigured in UTF-8 mode
- Firefox, homepage set to Apertium Wiki
Core tools installed via apt-get from repository https://apertium.projectjj.com/apt/ :
- CG-3 IDE
It automatically logs in to a 1024x768 desktop. All passwords set to 'apertium' for when root is needed. Keyboard and timezone are set to US English, but you can change the keyboard layout from the desktop shortcut.
On first boot, it looks something like:
Functionality was verified by compiling and testing apertium-kaz-tat, and the result was purged to save space.
The image is set up as a dynamically expanding hdd with max size 64 GB, where 8 GB is allocated to swap space.
- VirtualBox from http://virtualbox.org/
- If you downloaded the 7z archive: 7-Zip from http://7-zip.org/ or something else that can decompress 7z files
Step-by-Step Installation Instructions
1. Download the file (https://tinodidriksen.com/uploads/Apertium-VirtualBox-20191205.7z).
2. Use 7-Zip or a similar program to unzip the file. There should be exactly one thing in the unzipped folder - the Virtual Disk Image (VDI) entitled Apertium (Debian Sid).
3. Start VirtualBox and click "New" to create a new virtual machine.
4. For the OS Type, select Linux, Ubuntu (32 bit).
5. For Memory, give it at least 1024 MB RAM - it might run with less, but the more the better. In System, enable VT-x from the Acceleration submenu.
6. For Hard Disk, select the "Use an existing virtual hard drive file" radio button. Pick Apertium (Debian Sid).vdi from the drop-down menu, or if it isn't there, click the folder icon with the green arrow to the right and navigate to wherever you unzipped the file to. Finish the process by clicking "Create".
7. You can now run the new virtual box. On first boot it should look like this: https://tinodidriksen.com/uploads/Apertium-VirtualBox-20140418.png
Now you should have a system with all the prerequisites installed, and you should be able to follow How to bootstrap a new pair to install a language pair (and possibly any required language modules).
To get the clipboard working between the virtualbox and Windows/OS X, go into Options of that VBox -> General -> Advanced tab -> Clipboard -> Bidirectional.
Copying files between Windows and the Virtualbox
You can have Virtualbox mount the Windows drive through VBox's shared folder feature:
- Click "Devices" → "Shared Folders" and find a windows folder you want to share, giving it a name like
Shared. Tick "Make Permanent".
- Create a directory in the virtualbox to share it to:
sudo mkdir /media/windows-shared
- Mount it like this:
sudo mount -t vboxsf Shared /media/windows-shared
- To mount it on each reboot, do
sudo gedit /etc/rc.localand write
sudo mount -t vboxsf Shared /media/windows-sharedbefore the "exit" line.
It's easy to install a new language pair on Apertium VirtualBox. The instructions differ for released apertium pairs and unreleased pairs. To get a list of released apertium pairs, run the following in a terminal:
$ apt-cache search apertium- | grep trans
Installing a released pair
To install a released apertium language pair in Apertium VirtualBox, just run the following, substituting "nno-nob" (Nynorsk-Bokmål) with the language pair of your choice.
$ sudo apt-get install apertium-nno-nob
Installing an unreleased pair
Using a language pair
There are several ways you can use a language pair.
1. You can pipe text through it, e.g.
$ echo "this is random text" | apertium nno-nob
2. You can use it in interactive mode, by running it and typing text, e.g.
$ apertium nno-nob this is random text
3. You can use it to translate a file; if you add a second filename, it'll output to that file, e.g.
$ apertium nno-nob infile.txt outfile.txt
4. You can also run a file through it by piping the file's contents through it, e.g.
$ cat file.txt | apertium nno-nob
You can then use the