Mac4Lin Documentation

Mac4Lin Documentation

Project Documentation

Version 1.0

Revision 1.0.1

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

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 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 bit 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

64-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

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]:

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

Instructions for GNOME Systems

This section of the documentation is written for GNOME 2.22 based systems The GNOME version can be checked by clicking on System > About GNOME If your

computer runs an earlier version of GNOME you may want to refer to the older

documentation, available for downloading as a PDF document at

http://sourceforge.net/projects/mac4lin/ The screenshots shown may differ from your computer, but these were taken on a system starting with the Human-Murrine Theme

ran the installation script

you will see a new theme

labeled Custom This is

due to a glitch in how the

theme installed, but if you

scroll down you'll see two

new themes called

Mac4Lin_Aqua and

Mac4Lin_Graphite The

thumbnails show the

Mac4Lin_Aqua theme uses

colorful “traffic lights” for

the Minimize,

Maximize/Restore and Close

buttons and check

boxes/radio buttons, while

the Mac4Lin_Graphite uses a

more neutral set of buttons

The theme you should use

is purely a matter of personal preference

Past versions included themes labeled MacMenu, but the current themes work both with and without the GlobalMenu (formerly known as the MacMenu hack) so you no longer need to worry about which theme you activate beyond your choice of aqua and graphite color schemes

Please Note: The GlobalMenu panel applet brings the OSX standard of all menus appearing in a single location, in the top panel on your desktop As of this writing it still doesn't work with all applications, especially non-GTK applications (notably the

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

2.2 Shifting the order of the titlebar buttons

The installation script will move the “traffic lights”, the minimize, maximize and close buttons, on the left hand side of the titlebar in Metacity

(instructions for using the Emerald/Compiz Fusion theme appear in Section 4) If you want to make the change manually, press Alt+F2 and type in gconf-editor Press Enter or click Run and a new window should appear In the sidebar, go to / → apps → metacity → general Back on the right hand side, double click on

button_layout Delete the value that's there and type in

menu:minimize,maximize,close Then Click OK and close the application

Configuration Editor The buttons will now be on the left side of titlebar To restore the buttons to the original layout, just replace the string with

close,minimize,maximize:menu.

3 Using the GTK Icon Theme

As soon as you enable one of the Mac4Lin themes you have all of the Mac4Lin icons The theme also includes icons for many applications, as well as for the basic parts of

a GNOME-based GTK/Linux distribution You will, however need to add some applets

to complete the OSX look

4 Adding the necessary

panel applets

For the Search/Network/ Wi-Fi icon to

work correctly, you need to add

relevant applets to your GNOME panel

Right click on an empty area on the

GNOME panel and select Add to

panel Then scroll down and select the

Search for files applet Now again

follow the first part, this time select the

Network Monitor Applet Look at the

main screenshot for suggested

placements on the panel

4.1 Extra “goodie” icons This theme also contains a lot of extra icons To access them, Go

to Places → Home Folder and press Ctrl+H: A number of new folders should appear Look for

the one named icons and open

it Then open the

Mac4Lin_Icons_v1.0 folder and

you should see a folder named

EXTRAS Double click the folder

to open it Some of the icons in the pack are shown on the left

5 Emerald Compiz Theme

If you are using Ubuntu, you will find that Compiz Fusion pre-installed You just need to install your graphic card driver (if you need to, that is) If it's not installed on your system After that go to Applications → Accessories → Terminal Type in sudo aptitude install emerald

You will need to install he Emerald window decorator Go to Applications →

Accessories → Terminal Type in sudo aptitude install emerald That will install Emerald, a window decorator you will need if you don’t like the GTK window

decorator For other GNU/Linux distributions and/or operating systems please check your Package Manager for the relevant package

The installation

script installs

two Emerald

themes, but you will

have to enable the one

you want to use Go to

System → Preferences →

Emerald Theme

Manager Scroll down

until you see the

Mac4Lin themes and

select either the

Mac4Lin_Emerald_

Aqua_ v1.0 theme if you

use the Aqua GTK theme

or the Mac4Lin_

Emerald_Graphite_v1.0

theme if you use the

Graphite GTK theme Once you click on the theme it will be enabled, so once you have the theme you want enabled simply click Quit to close the Emerald Theme Manager

The Mac4Lin Emerald theme will move the close/min/max (traffic lights) to top left corner of the window If you want them in the top right of the window, open the

Emerald Theme Manager, make sure the theme you're using is selected, and click

on the Edit Themes tab Once you're in the theme editor section click on the Titlebar tab, then click on the box

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.

6 GTK Cursor Theme

The installation script installs the Mac4Lin Cursor Theme automatically When either the Mac4Lin Aqua or Graphite theme is selected the cursor theme is automatically applied

7 GDM Login Window Theme

7.1 Installing the GDM login theme

Go to System → Administration → Login Window (entering your Administrator

password when asked) and select the Local tab Click the Add button and select the

file Mac4Lin_GDM_v1.0.tar.gz Scroll down until you see the Mac4Lin GDM with it's preview and click the circle next to the it to select the theme Make sure Selected only is chosen above as Theme, or else you will have a random theme selected from any theme checked when you log in Click the Close button and log out (System → Administration → Log Out) to verify that you have the Mac4Lin GDM Login Theme enabled

Here's a sample screenshot of the Mac4Lin GDM Login theme:

8 GTK Splash

8.1 Configuring the GTK splash theme with gTweakUI

Although gTweakUI hasn’t been updated since 2004, it is still very easy to apply the splash theme with it

To install it, Go to Applications → Accessories → Terminal and type in sudo aptitude install gtweakui Once it's installed leave the Terminal window open for now For other GNU/Linux distributions and/or Operating Systems please check the Package Manager for the relevant package

Type in “sudo nautilus” (without quotes) and in when the Nautilus window opens it will look different because it won't use the same theme that you have selected

Navigate to the /home/<your username>/<the extracted Mac4Lin folder> Copy all

splash images files from the GTK_Splash folder to the folder /usr/share/pixmaps/ splash.

Now go to System → Preferences → gTweakUI → Session Then click on the big

square at the bottom and select the image you want as your splash screen

8.2 Configuring the GTK splash theme with Ubuntu Tweak

If you are using Ubuntu (or Fedora 10) you may want to use Ubuntu Tweak to set the GTK Splash screen as explained below Ubuntu Tweak is used by a lot of Ubuntu users, and is updated regularly, so this is the better choice if you want to keep up-to-date With the release of Ubuntu Tweak 0.3.4 it can now keep itself updated, as well as several other programs You can get the current version of Ubuntu Tweak at http://ubuntu-tweak.com/

Go to Applications → Accessories → Terminal and type in sudo nautilus and in the address bar, type in /home/<your username>/<the extracted Mac4Lin folder> Copy all the images files from the folder /Mac4Lin_v1.0/GTK to the folder

/usr/share/pixmaps/splash.

Now go to Applications → System Tools → Ubuntu Tweak On the sidebar, go to Startup → Session Control Click the big box at the bottom to change the splash screen

9 USplash Screen (Boot splash)

9.1 Installing the USplash startup theme

Please note: The Usplashes currently don't work with Ubuntu 9.04 “Jaunty

Jackalope” As soon as we get it working we'll post a notice on both our website and

in our Ubuntu Forums support thread

The installation script can't install the USplash boot theme so you'll need to do it yourself First go into the folder that you extracted Mac4Lin into (not the

Mac4Lin_v1.0 folder that the installation script created), and open the USplash folder Select both files in that folder, right click them, and select Extract Here That will get you the actual USplash themes that you need

Configuring start-up related things are made easy with the application

StartUp-Manager To install go to Applications → Accessories → Terminal, and type in sudo aptitude install startupmanager Don't close the Terminal after installing StartUp-Manager For other GNU/Linux distributions and/or Operating Systems please check the Package Manager for the relevant package

Important: Use StartUp-Manager at your own risk If you mess it up, your computer might not boot up properly! It is strongly recommended that you back up the GRUB menu list before you do anything with StartUp-Manager Open up Terminal again (with Applications → Accessories → Terminal) and type in sudo cp

/boot/grub/menu.lst /boot/grub/menu.lst.copy

Once you have the two USplash files extracted go to System → Administration → StartUp-Manager In the Boot options tab, check the Show boot splash option under Misc Now move to the Appearance tab

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

usplash_1.0s uses an OSX-like spinning progress indicator, while

Mac4Lin-usplash_1.0p uses the traditional progress bar

10 Font Configuration

10.1 Installing the Mac OSX fonts

Go to the extracted Mac4Lin folder and look for the subfolder Fonts Right click and

press Extract Here on the file fonts.tar.gz A new folder, fonts, should appear Open

it and you should see a collection of forty-four ttf files.

To install Mac OSX fonts, goto Places → Home Folder You need to enable Show Hidden Files, and you already know how to do it: press Ctrl+H If you don't see a

folder called fonts, right click anywhere and press Create Folder Name it fonts Now simply copy all of ttf files from the extracted folder above to the fonts folder.

An example of font settings

using the newly added fonts:

11 GRUB Splash

The GRUB Splash can be installed manually by editing the /boot/grub/menu.lst file

or by using StartUp-Manager to configure this part

Use this software at your own risk, if you

mess it up, your computer might not boot up

properly! So it is strongly recommended that

you back up the GRUB menu list before you do

anything with StartUp-Manager Open up

Terminal again (by Applications → Accessories

→ Terminal) and type in sudo cp /boot/grub/

menu.lst /boot/grub/menu.lst.copy Don't

close the Terminal yet, though

Now type in sudo open nautilus When the

file browser opens up, type in the address bar /

boot/grub Right click, press Create Folder, and

name it splash Copy and paste all xpm.gz

files from the Mac4Lin folder GRUB.

Goto System → Administration →

StartUp-Manager Goto the Appearance tab Now click

on Manage bootloader themes and click Add

Locate the xpm.gz image you want to set as the GRUB boot screen and add it Select

the image from the Grub background image button

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

globalmenu/w/list)

(http://code.google.com/p/gnome2-To install GlobalMenu on Ubuntu Linux

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)