Revision 1.0.1 June 26, 2009 Developer and Guide Copyright: Anirudh R. Acharya (infra_red_dude) Website: http://sourceforge.net/projects/mac4lin
Table of Contents
Project Overview ......................................................................................................3 1. Getting Mac4Lin ...................................................................................................4 2. GTK Metacity Theme ............................................................................................8 3. Using the GTK Icon Theme .................................................................................11 4. Adding the necessary panel applets ...................................................................11 5. Emerald Compiz Theme .....................................................................................12 6. GTK Cursor Theme .............................................................................................13 7. GDM Login Window Theme .................................................................................13 8. GTK Splash ........................................................................................................15 9. USplash Screen (Boot splash) ..............................................................................17 10. Font Configuration ...........................................................................................19 11. GRUB Splash .....................................................................................................20 12. GlobalMenu ......................................................................................................21 13. Launcher Docks ...............................................................................................23 14. Widget Layer ....................................................................................................25 15. Pidgin Theme and Plugins ................................................................................26 16. Exaile Avant-Window-Navigator Plugin ............................................................29 17. Mac OSX Sounds ..............................................................................................30 18. iTunes media player skin ..................................................................................31 19. Firefox and Thunderbird Themes and Extensions .............................................32 20. Mac4Lin and WINE ............................................................................................35 21. Changing the Main Menu icon ..........................................................................38 22. Desktop Backgrounds ......................................................................................39 24. Other Screenshots.............................................................................................41 24. FAQ and Troubleshooting ................................................................................43 25. Credits and Information ...................................................................................44
Typographical Styles
Throughout this document we have used several typographic styles to mark specific things. Red Bold Text Text marked with red bold text indicates things that require special attention. Usually paragraphs started with red bold text are things that you either want to make sure you do, or are things you may not want to do. Bold text Bold text indicates the names of files or folders (directories), or partial file names.
Italicized text Italicized text indicate things that you need to click on. Any button or tab we talk about is also shown in italicized text.
Monospace font Text written in a monospace font on a light gray background are things that you need to type in. Text in a monospace font on a white background is simply text that you will see displayed in the Terminal or dialog box.
Project Overview
Do you want to give your GTK or Xfce desktop a dash of Mac OSX? Do you want to change the default look of your desktop to something like this? Then read on.... Is that Mac OSX Leopard??? Naah... Its just GNU/Linux + (GNOME|Xfce) + Mac4Lin! The goal of this project is to bring the look and feel of Mac OSX into a GNU/Linux or Unix-System, such as GTK- and Xfce-based systems. This document will walk you through the procedure of installing the Mac4Lin pack and help you tweak certain things to get that almost perfect Mac OSX-like desktop. Mac4Lin Version 1.0 includes a script that makes certain steps of the install process quick and easy. Steps handled by the script will be indicated by the icon on the right. Mac4Lin works with both GNOME-based systems, and as of version 1.0 Mac4Lin now supports Xfce-based systems right out of the box. You can see a screenshot in the More Screenshots section of this file (page 41). Note: Backup all files before deleting/replacing the original ones. The Mac4Lin development team is not responsible for any loss of data that may occur when installing and/or during the usage of Mac4Lin.
1. Getting Mac4Lin
Download the Mac4Lin .tar.gz file from http://sourceforge.net/project/mac4lin/. Once it's saved to your hard drive, locate it and right click on it, selecting Extract Here from the context menu. Once you've extracted it open a Terminal and navigate to the location you extracted it to, i.e. cd ~/Desktop/Mac4Lin_v1.0 if you saved and extracted the file to your Desktop. The you need to run the install script by typing the following in the terminal window: ./Mac4Lin_Install_v1.0.sh. You'll see the script go through its paces as it starts installing things. ************************************** Welcome to Mac4Lin Installer This installer will install most of Mac4Lin components and enable the UI Note: Xfce users will need to manually enable the UI **************************************
Installing Mac4Lin UI... Done! Installing Mac4Lin Icons... Done! Installing Mac4Lin Cursors... Done! Please enable the cursor theme from Appearances. Alternatively, you can select the Mac4Lin Aqua/Graphite Meta package to enable everything with one click
Installing Mac4Lin Emerald Window Borders... Do you want to enable Metacity Compositor? If you are unsure about this or use Compiz, type 'n' [y/n]? Most users of Ubuntu Linux find the Compiz compositing window managers, as it's installed by default, although some users may specifically have opted to use the new compositing feature in Metacity. If you don't know which you use, or if you specifically use Compiz, type n and hit enter. Installing Mac4Lin misc. componenets... Done! Nautilus location bar is now disabled by default This is a change that is being made in the interest of properly duplicating the OSX interface style. If you'd like to bring back the Location bar in Nautilus you can use View Location Bar. The script also disables the icons on the interface buttons, and you can re-enable them by launching the Configuration Editor by running Applications System Tools Configuration Editor or by running gconf-editor In the Terminal. ~/Mac4Lin_v1.0 directory contains the components which are to be installed manually. Please install the Mozilla UI manually Unfortunately there's no way to install the themes and extensions for the Mozilla family of programs (Firefox and Thunderbird) so you will need to install them manually. As the script tells you, they're located in ~/Mac4Lin_v1.0/Mozilla. If you use a 64bit install, you will need to manually install the AWN Pidgin 64bit plugin from ~/Mac4Lin_v1.0/AWN Due to the fact that most of Mac4Lin works fine whether you're using a 32-bit or 64bit version of the operating system you will have to install the Pidgin plugin for the Avant Window Navigator maually. You can select the version for your specific installation in ~/Mac4Lin_v1.0/AWN. Installing Mac4Lin Backgrounds... Done! The next thing the script will want to do is to install some things that need administrative access, but you have to give the script the proper access (sudo) password. The following components require root access. You can opt out of installing them as they can be manually installed as well. Would you like to install these components [y/n]?
If you say no, you will see Components requiring root access not installed. Install them manually. If you say yes it will ask for your password and then install the GDM Login Theme and Sounds and the GDM Theme. Installing Mac4Lin GDM Login Theme and Sounds... [sudo] password for [your username]: Done! Please set the Mac4Lin GDM Theme manually by going to System > Admin > Login Window > Local > Theme
Please assign the sounds to events manually (OS wide as well as Pidgin). All the audio files are in /usr/share/sounds directory The installation script can't change the settings for your system sounds so you'll need to do it yourself. You can find them all in /usr/share/sounds. You will also need to manually select the GDM login theme, as we cover in section 7. The script will continue to run and install the Mac4Lin Pidgin theme. You'll see a note that says Installing Pidgin theme... tar: Removing leading `/' from member names Done! The current Pidgin theme has been backed up as ~/Mac4Lin_v1.0/Backup/pidgin_backup.tar.gz Please enable the Pidgin AWN plugin from within Pidgin and place a launcher for Pidgin on AWN Unlike in prior versions, Mac4Lin's installation script now updates the Pidgin theme, backing up the original theme for you. If you update Pidgin after installing Mac4Lin you will need to reinstall the Mac4Lin Pidgin theme. If you already have a launcher for Pidgin set up on your dock you shouldn't find any issues. You will want to double check in Pidgin that the AWN plugin is enabled. The plugin allows AWN to change the icon based on your status and activity, as described in section 15.
Whether you let the installation script install components that require administrative access or not when the script finishes you'll see **************************************** Mac4Lin installation complete! Please refer to the documentation for advanced installation instructions (for usplash, grub, tweaks etc.) For best results, log off and log back in for all changes to be applied ****************************************
Homepage: http://sourceforge.net/projects/mac4lin
Press any key to continue... After you press any key to finish out the script (we like using the spacebar ) you will need to log out and then log back. Simply use System Quit... Log Out. The screen that comes up when you log in is the GDM Login screen, which needs to be set manually. There are still some manual changes you need to make manually, but this gets you through the main part of the installation. The next section will start looking at rest of the things that you need to do, mostly manually, to install Mac4Lin.
Opera web browser, Mozilla Firefox and Thunderbird, and the OpenOffice.org office productivity suite), but there are community members who are hard at work to bring MacMenu out of the realm of hacks and into the real of a real option for Linux, especially GNOME, users. For more information read the thread at http://ubuntuforums.org/showthread.php?t=241868 in the Ubuntu Forums and the Global Menu wiki page at https://wiki.ubuntu.com/global_menu). Select the theme you want to use, either the Aqua theme with it's more colorful look or the desaturated graphite theme. The installation script said the Mac4Lin Cursors will need to be enabled manually; by selecting one of the above Meta themes the cursor will be automatically applied for you.
10
11
marked Title-bar Object Layout. Change it to HM:I(5)T:N(5)X(5)C, or what ever order you want, using the key below the text box to see what all the codes mean.
13
14
8. GTK Splash
15
16
17
Click on Manage usplash themes... near the bottom and in the new pop-up, press Add. Browse to where the .so files have been placed and add them. Now click the drop-down menu and select your USplash theme. Users of source-based distributions will need to compile the .so file manually with the USplash sources provided. Sample screenshot of the Mac4Lin bootsplash screen is below. The Mac4Linusplash_1.0s uses an OSX-like spinning progress indicator, while Mac4Linusplash_1.0p uses the traditional progress bar.
18
19
20
12. GlobalMenu
Before we install an OSX-like doc application let's take care of the menus. One thing that the MacOS has that neither GNU/Linux nor Windows comes with is the ability to have all of your applications in one place. Rather than having the menus for each application in their own menu, the MacOS devs have decided to move them all to the panel at the top of the desktop itself. This may seem, and feel, weird to anyone who has used another operating system, but MacOS users love it and some Mac4Lin users may want to be able to use it. Luckily for us some very smart GNU/Linux users have created a program that brings just about everything to a single menu location with the GlobalMenu project, which used to be known as the MacMenu. The GlobalMenu doesn't work for non-GTK applications (such as Mozilla's Firefox and Thunderbird as well as the OpenOffice.org productivity suite) or any KDE applications (such as Amarok). It also won't work with any applications you run with sudo permissions (like Synaptic), but that's purely a safety precaution. If you want to see a complete list of supported applications you will find it on the GlobalMenu wiki. It used to be a royal pain to compile it and get it installed, mostly because it felt like you had to spend hours chasing down dependencies, but now you can not only grab the source code from Google Code, the Ubuntu GlobalMenu Team has set up a Personal Package Archive (PPA) that makes getting the GlobalMenu setup a (relative) piece of baklava. For instructions on how to install it on Fedora or build it from the source code there are instructions on the GlobalMenu wiki. Prior builds of the GlobalMenu required Vala, but that requirement is no longer in effect if you use the GlobalMenu Team PPA (as laid out here). If you aren't running Ubuntu Linux you can get installation instructions for other GNU/Linux distributions on the GlobalMenu wiki (http://code.google.com/p/gnome2globalmenu/w/list). To install GlobalMenu on Ubuntu Linux from the PPA start by adding these lines to your /etc/sources.list: deb http://ppa.launchpad.net/globalmenu-team/ppa/ubuntu jaunty main deb-src http://ppa.launchpad.net/globalmenu-team/ppa/ubuntu
Mac4Lin 1.0 Documentation 21
jaunty main Save sources.list and close it, then install the GlobalMenu with sudo apt-get install gnome-globalmenu. Once it's installed let's get it on your upper panel. You probably have the Menu Bar applet with the GNOME foot and the standard three menu items. When you use the GlobalMenu you will want to have as much real estate possible for the GlobalMenu applet to show you the active application's menus so right click on the any part of the Menu Bar menu applet and select Remove From Panel. Now right click in that newly empty space on your panel and select Add to Panel.... When the dialog opens scroll down and select the Main Menu applet, dragging it to the far left of your panel. Next scroll up and find the Global Menu Panel Applet. Drag it directly beside your Main Menu applet and you're almost home free. I say almost because you do need to set the preferences for your new applet. Right click on it and select Preferences. The one option you will need to enable is the top item, Enable Global Menu for GTK applications. If that option isn't selected you will have the program menus in each window, which goes against the reason for installing the applet in the first place. We recommend that you enable the Label option so that you will see the name of the active application on your panel. You can also enable the Icon option but that may be more a matter of taste. The Max title length is the number of characters in the application name that will be shown. If you have the Window Actions option enabled, clicking on the application name will show the standard menu used when clicking on the Menu button on the window's titlebar, and selecting the Window List option will provide a dropdown list of the windows currently open. If you select both the Window Actions and the Window List options you will get the Window List behavior. Once you have finished setting your preferences close the dialog. Now instead of having this
You should now have this (when the desktop itself is selected)
22
A compositor is required to run Avant Window Navigator (AWN), such as Compiz Fusion, xcompmgr, XFCE compositor or Metacity compositor. Since Ubuntu now has Compiz enabled by default, you may just need to install your graphics driver. (We have not listed AWN from Ubuntus repositories because it lacks some of the features we need.) While you don't need Compiz to run AWN you do need some kind of compositor like xcompmgr or the Metacity compositor. We suggest you look into both dock technologies and decide which one serves your needs best. The plugins and applets we provide, however, are for AWN.
13.1. Cairo-Dock
Lots of people love AWN (below), but one 3D compositing dock that also supports 2D (in case you have a slower, non-3D graphics card) is Cairo-Dock (http://www.cairodock.org/). The English section is found in their wiki at http://www.cairo-dock.org/ ww_page.php?p=Accueil&lang=en. We would include instructions for installing the Cairo-Dock but there are slight differences in the addresses for the repositories depending on what version of Ubuntu you're using. The wiki for updated repositories is http://wiki.cairo-dock.org/ww_page.php and is available in several different languages. One potential benefit of Cairo-Dock is that the latest release contains a built-in MacOS-style theme, pre-configured. While we support both Cairo-Dock and AWN, we recommend the use of Cairo-Dock.
13.2. Avant Window Navigator (AWN) 13.2.1. Installing the latest version of AWN
You can get installation instructions for AWN for Ubuntu/Debian, Gentoo, Mandriva, Fedora, openSUSE and Arch Linux from the AWM Wiki (http://wiki.awnproject.org/DistributionGuides). For Ubuntu we used to recommend using reacocard's PPA but he's no longer updating his packages. Luckily the AWN Testing Team has their own PPA that can be used for running the bleeding edge builds of AWN. due to the fact that the official repository packages may be missing some features we need. You can get instructions for installing AWN from the AWN Testing Team's PPA from the AWN Wiki at http://wiki.awnproject.org/Installation:Ubuntu#PPA.
23
You can also install it from the source code from the instructions at http://wiki.awnproject.org/InstallingFromSource.
On the sidebar of Awn Manager, click General. At the top, click the tab General, and check the option Automatically start AWN on login. In the Bar Appearance tab, choose 3D look from the drop-down of Look and uncheck Enable rounded corners. This is the emulation of the Mac OSX Docks Stacks. Goto System Preferences Awn Manager. Goto Applets (on the sidebar), and look for an applet named Stacks Applet. Click it, then click Activate. A new icon should appear on your dock. Right click it and press Preferences.
On the tab Backend, check Folder backend and navigate to the folder you want this applet to display. You can also use the File backend and simply drag and drop the items you want in your Stacks. Goto the Applet Layout tab and for the Applet title, name it what you want displayed on the dock. (For example, Leopard has it named Downloads for all downloaded files by default.) You can click the box for Composite applet icon to use an icon based on the file types you have in your Stacks or use your own icon for the Stacks applet. Click the images and in the new pop-up, navigate to the folder housing your icons, They are probably in the .icons folder off of your Home folder (~/.icons). Finally, goto the tab Stack Layout and choose Curved gui from the dropdown for an OSX-like curve to your Stacks. Click Apply to close the Preferences window. If the folder has a lot of items you may find a delay before you are able to use the AWN Stacks applet.
24
AWN: Although the Avant Window Navigator has some excellent applets, none of the pre-installed applets can be undocked to function as desktop widgets at this time.
Mac4Lin 1.0 Documentation 25
Status Idle/Invisible:
Status Available:
Status Connecting:
Status Offline:
26
27
28
29
30
31
32
33
After applying the extensions and add ons Firefox will now look like this:
34
0,4d,00,6f,\ 00,6e,00,6f,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00 "MenuHeight"="18" "MenuWidth"="18" "MessageFont"=hex:f5,ff,ff,ff,00,00,00,00,00,00,00,00,00,00,00,0 0,90,01,00,00,\ 00,00,00,00,00,00,00,22,42,00,69,00,74,00,73,00,74,00,72,00,65,0 0,61,00,6d,\ 00,20,00,56,00,65,00,72,00,61,00,20,00,53,00,61,00,6e,00,73,00,0 0,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,0 0 "ScrollHeight"="16" "ScrollWidth"="16" "Shell Icon Size"="32" "SmCaptionFont"=hex:f5,ff,ff,ff,00,00,00,00,00,00,00,00,00,00,00 ,00,90,01,00,\ 00,00,00,00,00,00,00,00,00,4d,00,53,00,20,00,53,00,68,00,65,00,6 c,00,6c,00,\ 20,00,44,00,6c,00,67,00,00,00,00,00,00,00,00,00,00,00,00,00,00,0 0,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,0 0,00 "SmCaptionHeight"="15" "SmCaptionWidth"="13" "StatusFont"=hex:f5,ff,ff,ff,00,00,00,00,00,00,00,00,00,00,00,00 ,90,01,00,00,\ 00,00,00,00,00,00,00,22,42,00,69,00,74,00,73,00,74,00,72,00,65,0 0,61,00,6d,\ 00,20,00,56,00,65,00,72,00,61,00,20,00,53,00,61,00,6e,00,73,00,0 0,00,00,00,\ 00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,00,0 0
36
With those changes made your Wine Configuration window will look like this:
37
If you use Fedora 10 or Ubuntu and have installed Ubuntu Tweak back on page 15 you should be able to use it to change the Main Menu icon, but as of this writing it doesn't seem to work with the Mac4Lin themes (hopefully this will be resolved in the near future). To use UTweak to change the Main Menu icon launch it and go to the Desktop GNOME section. You'll see a button with the GNOME footprint that is set as our Main Menu icon. Click the button and select any 24x24 icon. The icon has to measure 24x24 or you will get an error message. Once you've selected an icon you'll be asked if you want to apply the change immediately, but it's best to log out and log back in to let the change take place. Unfortunately even a restart won't show your replacement icon but the issue has been filed and hopefully UTweak will get updated to resolve it.
38
39
Congratulations!
Installation is now complete. Congratulations! You now have the Mac OSX user interface on your GTK desktop.
40
42
43
D.J."Peng" Hardin for updating the docs and Jeff Fessler for proofing them DrP for the Mozilla themes Mitko for the nm-applet Stido for weather icon replacement Mario Cupelli for letting us know how to resolve the KDE titlebar issue
I also thank all those who tested beta releases of Mac4Lin and everyone who is directly or indirectly involved in this project. For any bug reports, comments, complaints or suggestions, please head to the project website and/or drop me a mail at infra_red_dude.users@sourceforge.net. No part or whole of this guide should be reproduced without permission. The Apple logo is NOT bundled with the package. Anirudh R. Acharya (a.k.a infra_red_dude) Developer, Mac4Lin E-Mail: infra_red_dude.users@sourceforge.net Project Website: http://sourceforge.net/projects/mac4lin
44