EyeManual

    Welcome to eyeOS the Cloud Computing Operating System. Work online personally and or collaboratively with your files, office, calendar, contacts and much more. The idea of eyeOS is to create a free, open source (AGPLv3) product easy to install on a web server so you will have your own cloud system under your control.

    eyeOS is all about centering work and entertainment in a single place. eyeOS is about removing compatibility issues between applications and operating systems and taking your life everywhere.

    eyeOS is available in 30 translations. And is used privatively and professionally through out the world. rather it is used for public environments, schools, small and large companies alike or a way to share data with your family. eyeOS has a use in our the digital life era

The Goals for eyeOS

• Being able to work from everywhere, regardless of whether or not you are using a full-featured, modern computer, a mobile gadget, or a completely obsolete PC.
• Sharing resources easily between different work centers at company, or working from different places and countries on the same projects.
• Always enjoying the same applications with the same open formats, and forgetting the usual compatibility problems between office suites and traditional operating systems.
• Being able to continue working if you have to leave your local computer or if it just crashes, without loosing data or time: Just log in to your eyeOS from another place and continue working.

What Can You Do with eyeOS?

File management Upload multiple files Easy visual file management Download entire folders as Zip Compress and uncompress Zip/Tar files Photo viewer and slideshow Personal Information Management Calendar with multiple views Contacts manager Export and Import vCards System Packages Installer Repository based Ports Control system for groups and users Multiple instances of the applications

Office Word Processor Spreadsheets Presentations Support for MS Office and OpenDocument files Network Internal Messaging System Bulletin Board Proxied FTP Client RSS Feeds Reader Desktop Third-party applications Auto-run desired apps Translations Theming

Before we get started there are a few things we need to make sure we have before continue. If you are using eyeOS through a server that provides eyeOS pre-install all you need is the Client information.

Server

Server}

Hardware

Please follow the minimum requirements for the operating system as well as the requirements if any for the web server program.

Software

There are many web server programs out there and there have been good reports about eyeOS working well on all of them,with that said.

Recommended

• Apache Web Server 1.3.x or 2.x http://www.apache.org
• PHP 5 or higher http://www.php.net/

• Safe Mode = Off.

Client

Browser

eyeOS works in most all browsers. This can change from the operating system and version of the web browser. We highly Recommend Firefox 3 + for all OS's. Other browsers compatible Internet Explorer 6 +, Safari, Google Chrome, and Opera. Reports of many others have been reported

Plugins

eyeOS can work without any plugin installed. However, plugins can provide better experience

• Adobe Flash 9 +
• DivX Web Player

Resolution

Resolution < 1024x768

In This Section

• Acquiring Your eyeOS Package
• Quick Install Instructions
• Install Instructions
• Setting up on a remote host

Acquiring Your eyeOS Package

Open your web browser and navigate to http://eyeos.org/en/downloads or http://sourceforge.net/projects/eyeos/ you can chose from two packages a .zip and a .tar.gz if you are using a Microsoft product for your server chose .zip all others may use the .tar.gz

Quick Install Instructions

• Extract (unpack) the contents of your eyeOS.zip or .tar.gz file to a local directory.
• Upload the unpacked directory with all of its content to your web server directory.
• Give full read-write permissions to folder and the folders content. The final permissions will be set by the installer, no need to worry about giving too much permissions to it.
• Now launch your browser navigate to http://localhost/your_eyeos_Dir or http://xxx.yoururl.xxx/your_eyeos_Dir and follow the given instructions.
  

If you want to activate the Office Support, please follow the instructions on Office Support

Install Instructions

1. Extract (unpack) the contents of your eyeOS.zip or .tar.gz file to a local directory. Below are a few ways of doing this task

Mac: double click the .zip file and it will create a folder in the directory where it is

Microsoft: right click on the .zip file and select “Extract All...”

Linux, Unix: open a terminal and at the command prompt type "tar -xzf eyeOS_x.x.x.x.tar.gz"

2. Upload the unpacked directory with all of its content to your web directory. Web directory Is the folder that your web server looks to for the files to display. The location varies from server to server the best thing to do is go to the web page of your web server program you installed like for example xampp or wamp it will probably be in there FAQ. Here are a few examples

MicroSoft

$path-to-xxxx = C:\, D:\, E:\, .... drive you installed it on

xampp

$path-to-xampp\xampp\htdocs

wamp

$path-to-wamp\wamp\www

Linux

Ubuntu

/var/www/

Suse

/srv/www/htdocs/

Arch

/srv/http

3. Give full read-write permissions to folder and the folders content. The final permissions will be set by the installer, no need to worry about giving too much permissions to it.

Mac: To change permissions

• Choose File > Get Info and click Ownership & Permissions, if necessary. If you want to set permissions for multiple items at once, select them, and as you hold down the Control key choose File > Get Summary Info.
• Choose a permission from the pop-up menu
• To change permissions for the owner, group, or others, click “Detail”
• Choose permissions from the Access pop-up menus.

Microsoft: No permission settings. Move to step 4.

Linux, Unix: open a terminal and at the command prompt type as super user most do "sudo" or "su root"

type :#chmod 777 -R /YourWebDirectory one exsaple

#sudo chmod 777 -R /var/www/eyeOS

4. Now launch your browser navigate to http://localhost/your_eyeos_Dir or http://xxx.xxx.xxx/your_eyeos_Dir and follow the given instructions.

Setting up on a remote host

Not all host providers (hosters) will work with eyeOS. A few add advertisement to the code automatically that brack our code. And some will not allow safe mode off or even any configurable Php(pg.6) . Most of the ones that do these things though are the free or next to nothing hosters we have started a list at our eyeOS Wiki to list what we know of hosters you are welcome to visit it at http://wiki.eyeos.org/Confirmed_Hoster

You do not have a hoster yet or would like a detected host just for your eyeOS? Safehosting is a official partner of eyeOS, offers virtual servers always fully prepared to deliver the latest version of eyeOS, including support for working with Office files and OpenOffice. Please visit http://safehosting.com and click on eyeOS Servers

Setting Up

Please follow the steps for Install Instructions starting on page 3. With step 2 and 3 being replaced with the two steps below.

1. Upload to your server .

There are many ways to do this most of the time your hoster will give you a ftp account you can login and use you want to upload all the files in the Package that you unpacked or you can just upload the eyeOS director its self. if you are unsure how to upload pleas visit your hosters web site

2. Setting Permissions

In most cases, if the hoster is setup correctly this step should not be needed skip to part 4 If you see warnings about permissions problems in the eyeOS setup screen, we will need to set permissions. There are many ways to do this depending on how you upload your files the best thing to do is visit your hosters web site for more information.

In This Section

Server

• Php
• Office Support

eyeOS

System preferences

• Personal
• Look & Feel
• Administration
• System

Server

Php

Php is a highly configurable scripting language. All of configurations applicable to PHP for modify how php works are inside a file called php.ini, the location of file php.ini depends of your Operating System and software versions. We only need to do this to control our upload size the default in most cases is 2mb if you require more then fallow the steps below

The location of the php.ini can vary from system to system and depending on what server you are using on that system below are a few places you may want to start with. As always it may be easier to search on the web

MAC

/usr/local/lib

Microsoft (Windows)

C:\Windows\php.ini

Linux

In linux usually it is located at:

/etc/php.ini

/etc/php5/apache2/php.ini

Now that we have found the php.ini. We first need to make a BACKUP! each time that you edit it.(you can just copy it to a different folder ) Now we want to open php.ini with a text editor and find and edit this lines

max_input_time = xxx memory_limit = xxM post_max_size = xxM upload_max_filesize = xxM

x=1,2,3,4, ... change the size to your desired amount

safe_mode = Off

Safe_mode should always = off . max_input_time may only need changing if you set

Office Support

To have it were we can have our eyeOffice work to its fullest. We need to install openoffice2.4.2 on our computer with eyeOS on it

We can download openOffice from their site and install it now openOffice 3.0 is out so we need to get it from there Mirrors Site. Pick your closes server then we want to inter in stable then go to 2.4.x then select what is the right one for you

Microsoft

1.Run as Administrator

• Launch "services.msc".
• Go to the dialog "Properties" of your Apache service and choose the "Log On" tab.
• Activate "This account" and click "Browse...".
• Confirm an administrator account and click "Check Names".
• Click OK and save and restart the Apache service.

2.Documents and Presentations

• "<ooo-path>" is the installation path of OpenOffice.org. default path is

C:\Program Files\OpenOffice.org 2.4\

• Download OpenOffice.org 2 from http://openoffice.bouncer.osuosl.org/?product=OpenOffice.org&os=win&version=2.4.2 and install it.
• Copy "extras/OpenOffice/eyeOS.xba" into "<ooo-path>\share\basic\Tools\".
• Edit "<ooo-path>\share\basic\Tools\script.xlb" and add "<library:element library:name="eyeOS"/>" at the end of .
• Go back to eyeOS >> "System preferences" >> "System" >> "Office Support".
• Update the "program" folder path to "<ooo-path>\program\" and click "Save changes".

3.Spreadsheets

• Download "7-Zip Command Line Version" from http://7-zip.org/download.html .
• Extract it and copy "7za.exe" into "eyeOSxxxxxxxx/extras/7-Zip/".

Linux

Below is a few thing that is needed. How you install them will vary from distribution to distribution. You should look at our

• Install OpenOffice (eyeOS uses OpenOffice to convert formats).
• Install xvfb (OpenOffice needs a X server to be executed in).
• Make sure that the owner of the home directory of the apache user (www-data or nobody in some installations) is the apache user. For example, in Debian installations the apache user is www-data and the home for the user is /var/www but this directory is owned by root. You can change the home for apache user to /tmp if you don't want to change the owner or create a new directory.

• Copy

youreyeOSDir/eyeOSxxxxxx/extras/OpenOffice/eyeOS.xba

from the eyeOS installation directory to

/usr/lib/openoffice/share/basic/Tools/

• Edit

/usr/lib/openoffice/share/basic/Tools/script.xlb

and add

<library:element library:name="eyeOS"/>

under

<library:element library:name="Debug"/>

should look like this

<library:element library:name="Debug"/> <library:element library:name="eyeOS"/>

After that you may open a terminal and type in

Xvfb :1 -ac -screen 0 800x600x16 -fbdir /tmp &

type as shown xvfb will not work must be Xvfb

eyeOS

System preferences

    eyeControl is both the System preferences application where you can choose all your desktop settings and preferences, and the system administration menu where you can change your system's behavior if you are logged in as the root user. If you are not root or a administer you will see used space of your account in the bottom right

To open eyeControl, click on System preferences in the eyeBar menu.

Personal

	About me Update your system's profile: Username, Full name, E-mail, list the Groups that you belong to: After changes do not forget to press Save changes
	Password If wanting to change your password. Input your Current password in the appropriate box and type your new password in the next two boxes then press the Change Password button
	Language Change yours or the default preferred language. Chose your language from the drop-down box. (If you do not see your desired language below you will see a link “Get more translations” click on that link and eyeNav will send you to our Translations page as a .eyepackage {pg.} ) If you wish to change the default preferred language for all users as root in the lower right corner you will see a drop-down box called “Select user” Chose [Default user] and repeat above

Look & Feel

If you wish to change the look in feel for all users in the lower right corner you will see a drop-down box called “Select user” Chose [Default user].

Desktop Wallpaper If you chose to use a different wallpaper then the themes. Check-mark the “Use a custom wallpaper” box. Then “Select a file...” button browse through your eyeOS file system (note: you must of uploaded your wallpaper to your eyeOS file system first) and select your desired image. Then we have the option to repeat wallpaper and or center wallpaper. Do not forget to press Save changes

Settings Do not forget to press Save changes Windows You have the option to save your window positions if you close out a sasion and log back in at a later time eyeOS will save your windows positions Desktop icons chose how icons on the eyeOS desktop behave. Fixed: Icons cannot be moved Smooth: Icons can be moved everywhere Fielded: Icons are aligned to a gride automatically Mouse by default all icons you only need to click once to open files and apps here we can chose to use double-click. Just check-mark the “Use doubleclicks” Box

Theme eyeOS comes with 3 themes and more can be downloaded. Just selict you disered theme frome the drop-down box and press “Change theme” If you want to change the login screen theme you must change the [Default users] theme

Administration

Note that you must be logged as root user in order to be able to see and update the system administration panels

	ACL Access Control List, allow/deny users certain actions in the system, ACL tables makes it possible for the system administrator to manage the rights of the users in the system.
	Clean eyeOS eyeOS will see if your Tmp file need cleaning if so you will have the option to do so
	System At the top you will see tabs to chose from below we will go through what each does eyeOS hostname This is the name that appears as the browser's title after the username and the welcome massage when we first login to our account Default language Chose the Default language from the drop-down box. If you do not see your desired language please read page __ Personal > Language
	User quota A quota is a limit on how much space can be used. So here we can set the amount of space each user has or we can turn it off all together. Set the numeric value and then from the drop-box you can chose from byte. kilo, mega, and gigabytes Create thumbnails Select if you would like eyeFiles (pg.) to show a preview of image files or not
	Permissions Allow user registration If enabled at the login screen new users can register and make new accounts Allow public dirs Chose if you want to have public directory to share or to disable them Allow web upload with web upload (pg.) you can find the url of the file and copy it into web upload and click Upload and it we download to your eyeOS file system directly
	Cache System Enable cache system enable or disable the cache system Current cache version If you have modified any theme inside eyeOS, you must increase this number to be sure that all your users get a fresh data. Patch CSS files allow you modify how eyeOS patch the urls that are inside the css files. There are 3 ways: Manual: eyeOS doesn't patch the css files so it must be done manually. Automatic: eyeOS automatically patch all css files in each request. Semi-automatic: eyeOS only patch the css the first time that is requested.
	Office Support Please read Office Support Secsion under Configuration:Server
	Uninstall Completely uninstall your eyeOS from this panel, by typing your root's password and clicking on “Uninstall eyeOS” button. This is useful when you want to completely remove your eyeOS installation and you can't do it due to the permissions assigned to eyeOS files during the Installation. Note:Uninstalling your eyeOS can't be undone. Please do it only when you and all the users inside your system have backed up all the important data.
	Managing Users Allows use to remove, edit, and create users. When we first select managing users a pop-up window will appear so we can filter or search for our users New Input the Username, Password, if you like Full Name, and E-mail
	Permissions: Administrator: Has the same power as root over your eyeOS, Users, and groups without the option of uninstalling eyeOS Maintainer : Can Manage groups and users that a admin and or root user assigned to them User: can only maintain the files and folders that they make Expiration by default is set to Never. If you would like to set a date use this format dd/mm/yyyy ex. If the day is 1 month is June and the year 2009 you would enter 01/06/2009 Now we can select what Groups the user belongs to. Now we press the Create user button Edit Select the user from the list and press edit and follow the instructions above for New Delete Select the user from the list and press Delete to remove that user Load Press this icon to reload the list Note that you can't remove the root user and these action can't be undone.
	Managing Groups Create new groups to work collaboratively between users. This is one of the most important options inside eyeOS because it allows you to create shared folders between users, so they can work between them. New A pop-up window will open and you can input the name of the new group.
	Once it's created, it won't be assigned automatically to any user. You must go then to the Manage users menu, and edit the users to assign them to the new group. The next time that those users will log in into their account and go to Groups folder inside eyeFiles (pg.) they will see their new group and will be able to copy and manage files inside it. Edit Here we can rename groups Delete Delete groups Set as default Set a group as the default group so all new users will belong to this group
	Repositories Allow you to install applications from the eyeSoft ( pg. ) application automatically, without need to download or upload anything into your system. By default the official repository is already entered for us. New If you have an eyeOS repository URL and would like to add it ust click on the button and type the new repository URL.
	Edit Select the repository from the list and press edit to change the URL Test Select the repository from the list and press test to see if the link is active Delete Select the repository from the list and press Delete to remove that repository
	SMTP Open and follow the instructions

System

If you wish to change the look in feel for all users in the lower right corner you will see a drop-down box called “Select user” Chose [Default user].

	eyeOS Board Change your eyeBoard (pg. )settings. Show full names: if you would like to see full name or nick name. Refresh interval: set the refresh interval in seconds
	Autorun Commands Manage your autorun commands. If you would like a eyeApp to open when you login you can set it to do so here or edit, delete ones that are set as well as reseting to the default configuration
	Web Browser Manage eyeNav's (pg.) startpage, bookmarks and search engines as well as exporting to a file for backup, sharing, or transporting
	Security Protect Sessions by IP if checked only one IP address per login permitted so if you are loged in at home and someone finds your username and password at work they will not be able to have access. Caution! If you do not end session at point A you may not be able to login at point B

Open your favorite browser on any operating system and type in the address of the server where eyeOS is located.

After inputing your eyeOS url you will see the eyeOS login screen.

If you already have an account on this server, just type your Username and Password and if needed select your language then Press “Enter” to log into your Desktop.

If you do not have an eyeOS account on this server, and you see the “New User” button on the lower left corner you can create a new user. Press new user and fill the form with your desired Username and Password.

Note: that the username must have at least 4 characters, and that you have to introduce your password twice to ensure that you have not typed it wrong.

Once you have filled the username and the password, and selected your Language click on “Create account”

If a message saying that your user has been created successfully appears, you can log in now using the Login Box, introducing the Username and Password you have just chosen while creating your user. If not, a message will instruct you in what to do.

Just after pressing the “Enter” button, the Login Box will fade off and your eyeOS Desktop will appear. You will then be in your eyeOS Desktop

For this Overview we will divided our eyeOS Desktop in three zones: the Applications Dock, the Desktop, and the System Panel.

On the top of the Desktop you will see the Applications Dock (known as eyeDock), where you will find the base applications ordered by categories. To see the applications in a category just click on the category's icon. To launch an application, click on the application's icon or description.

Learn more about this eyeDock including customize

on Page __

In the right zone of the Desktop we have the default Icons: Address Book, Applications, Calender, Home, Rss Feeds Reader, and Trash. By clicking on these icons, we will launch there applications

The Applications icon is where you will be able to view and launch every installed application on your eyeOS system. As well as customizing the eyeDock. From here we can add and remove Applications if you are the “root” user or have administrator privalges

The Calender icon

The Contacts icon

The Home icon You will also be able to launch some files which are recognized by eyeOS. This includes images, videos, text documents, compressed files, eyePackages (eyeOS Installable Packages) and more.

The Applications icon is where you will be able to view and launch every installed application. Read more on page

The RSS Feed Reader icon

The Trash icon will open your trash bin, where the deleted files will go before being completely removed from the System. (see Illustration 7). You should check periodically the trash bin, since the files on the trash are also part of your File System, and you may find your disk quota full because of the files in the Trash.

Just over the Bottom Bar you will see the System Bar, which can be opened by clicking the green eyeOS bar at the center bottom part of your Desktop. From the System Bar you can do some common actions (see Illustration 8):

• Close session: It will close your current session and go back to the Login Screen. Please note that all unsaved documents will be lost!
• Launch App: Use it to launch an application by typing its name. You can also use it to use system utilities (for example, type on the eyeLaunch “killall APPNAME” to close the APPNAME application).
• About eyeOS: In the eyeInfo Screen you will see the eyeOS version that is being used, and the names of the eyeOS team members, as well as some special collaborators.
• Applications: It will launch the Applications Folder, just as the Software Icon in the Desktop will do. (see Illustration 6).
• System preferences: Click to launch the Control Center. If you are logged in as a normal user, you will be able to change some options and preferences for your user and desktop (see Illustration 9). If you are logged as root user, you will see also some options to manage your eyeOS Server.

In the bottom of your desktop you will see an opaque bar, which contains the minimized applications. You can maximize a minimized application by clicking on its bubble. If you click on a maximized application's bubble, the clicked application will appear on the top of all the opened applications. Finally, if you click on the top application's bubble, it will be minimized.

At the right part of the Bottom Bar you will see a small bar, sightly darker than the minimized applications bar, which contains the current hour and date. If you click on the date (which is in DD/MM format) a small calendar for the current month will appear. To close the calendar, just click again on the date. (see Illustration 10).

eyeOS comes with a set of bundled applications that will allow you to work from the system with a wide variety of documents and files. you can just click on the file without any action selected Action, and the appropriate application will be launched opening the file.

login to any eyeOS system in by typing the target URL followed by /mobile/ from your mobile phone.

http: //xxx/yoururl.xxx/eyeOS/mobile

You will be able to read Office documents in your hand, see and upload photos from your mobile to eyeOS, and much more!

These are the Application that are bundled with eyeOS
	Office eyeDocs | eyeSheets | eyePresentation | eyeCalendar | eyeContacts | eyePdf
	Education eyePlot | eyeCalc
	Games eyeTetravex | eyeChess
	Other Apps eyeFiles | eyeString | eyeArchive | eyeOS Mobile
	Themes Default | Light Desktop
	Accessories eyeNotes
	Administration eyeProcess | eyeControl | eyeInstaller | eyeSoft
	Network eyeFeeds | eyeNav | eyeMail | eyeBoard | eyeUpload | eyeFTP | eyeMessages
	Multimedia eyeMp3 | eyeVideo
	miniApps(widgets) miniMessages | miniCalendar | minihome

eyeSync

eyeSync is a multiplatform that allows you to keep synchronized any folders of your computer with your eyeOS account. You must only specify an eyeOS server and an account, and then you will be ready to synchronize your data!.

To start using eyeSync, please install it on your operating system following the normal package installation for your system (Mac, Linux or Windows). You will notice that the look of the application is the same independently of the platform you're on.

• Step 1 - The first time you open eyeSync you should see a warning telling you that you must update your Preferences with your eyeOS Server and account.

After accepting the dialog, you will be in eyeSync main window.

• Step 2 - Go to Preferences menu and write the URL to your eyeOS server and your account and password. Note that your eyeOS server must end with a slash (/) and must start by http://. For example, if you want to use eyeSync with the public server just type http://www.eyeos.info/. Click on OK to save your preferences and go back to the main screen.

• Step 3 - Click on Add Folder and select which folder of your computer you want to synchronize with your eyeOS. You can repeat this step as many times as you want for each folder you want to synchronize.

Please note that when you click on Ok, eyeSync will start to sync the data of that folder with your eyeOS. If your system has an events notification system (such as Growl - http://www.growl.info - for Mac OS X), you will see a notice saying that the files are being synchronized.

You can now work on your files: eyeSync will detect every change on the files that are being synchronized and update them on your eyeOS. Please note that eyeSync won't sync the data from your eyeOS to your local system, but from your local system to eyeOS.

eyeDesigner

eyeDesigner is the Graphical User Interface Builder for eyeOS. It will help you to create quickly your applicaations' user interfaces

English | עברית | العربية | Български | বাংলা | Čeština | Deutsch | Español | Català | Suomi | Français | Magyar | Italiano | Nederlands | Polski | Português | Português Brasil | Română | Русский | Shqip | Svenska | Українська

I want to Change my Password how can I do this?

Login to your eyeOS system. After logging in go to your eyeBar Then go to System Preferences on the left side you will see Personal below that you will click on Password then follow the instructions.

//The real god of eyeOS users, master of masters
define('REAL_ROOTUSER','root');

//The real god of eyeOS users, master of masters
define('REAL_ROOTUSER','yourusername');

<password>4f5fba03a86607a215fe91bd47735689</password>