Documentation

Trisquel is a fully free as in speech GNU/Linux operating system. It is based on Ubuntu, but includes only free software.

Trisquel has several editions, designed for different uses: the one called simply Trisquel ― get this one if you are in doubt ― is intended for home and personal use, and includes a lot of apps for that: networking, multimedia, office, games, etc.

The Edu edition is designed for educational centers, and allows the teacher to build a custom digital classroom within minutes.

The Pro edition is for enterprises, and includes accounting and management software.

The Mini edition is for netbooks, networks, aging computers, and otherwise low-power systems. It is still in the design process.

Versions

We have two versions of the distro: the 2.x LTS branch, codename Robur, and the 3.x STS branch, codename Dwyn. Both versions have several editions, which differ in the package selection as explained above.

All flavors come in both 32 and 64-bit architectures.

3.5 STS version

3.0.1 STS version

2.2.2 LTS version

Getting Help

Assistance is available from the manuals or, failing that, on the forum. Also, please help the project by submitting bug reports.

Editions

The project develops several editions of Trisquel GNU/Linux which share a common base.

There is also a community maintained edition: Trisquel Gamer, an edition for gamers which follows the current STS edition of Trisquel.

Previously we also developed Triskel, an edition which used KDE and QT applications.

Dwyn

The 3.x STS edition, codename Dwyn and based on Ubuntu Jaunty, was released on September 10, 2009. It was updated to 3.0.1 in December of the same year.

Dwyn is an STS (short term support) version, which will be supported for one year after release.

Software versions and distro editions

This version uses the following common software:

Support is included for the following languages:

  • English (default and with extras and writing tools [1])
  • Spanish (with extras and writing tools)
  • Basque
  • Catalonian
  • Chinese (with input tools)
  • French
  • Galician
  • Hindi (with input tools)
  • Portuguese

1: The extras include the OpenOffice.org help and spellcheckers. Chinese and Hindi SCIM input methods and tools are also included.

There is support for both 32 and 64-bit architectures.

Robur

The 2.x LTS edition, codenamed Robur, was the first Ubuntu-based Trisquel, released in July of 2008. It was updated to 2.1 in December of the same year, and to 2.2 in August of 2009.

Robur is an LTS (long term support) edition, which will be supported until mid-2011, getting security updates until 2013.

Software versions and distro editions

This version uses the following common software for its three editions:

The distro has three editions:

As for the 2.2 update, all three editions include support for the following languages:

  • English (default and with extras and writing tools [1])
  • Spanish (extras and writing tools)
  • Basque
  • Catalonian
  • Chinese (with input tools)
  • French
  • Galician
  • Hindi (with input tools)
  • Portuguese

1: The extras include the OpenOffice.org help and spellcheckers. Chinese and Hindi SCIM input methods and tools are also included.

All of the editions support 32 and 64-bit architectures.

Trisquel 3.5 Awen release notes

Trisquel 3.5, codename Awen is based on Ubuntu Karmic.

Awen is an STS (short term support) version, which will be supported for one year after release.

One interesting update included in this release is the new disk layout, using Ext4 for the system partition, including the boot directory for faster booting, and XFS for the home directory to lower memory consumption and avoid tedious memory ext4 checks for large partitions. We also followed our upstream by moving to Grub 2 and Upstart, for a more flexible boot manager and a faster system initialization.

Software versions and distro editions

This version uses the following common software for its three editions:

The media center Moovida, previously called Elisa, is a very cool manager for video, audio, images and internet media resources. We removed the Audacious player because the new version has fewer translations and its functionality is covered by Rhythmbox. We also added an ogg/ogv encoder.

Support is included for the following languages:

  • English (default and with extras and writing tools [1])
  • Spanish (extras and writing tools)
  • Basque
  • Catalonian
  • Chinese (with input tools)
  • French
  • Galician
  • Hindi (with input tools)
  • Portuguese

1: The extras include the OpenOffice.org help and spellcheckers. Chinese and Hindi SCIM input methods and tools are also included.

There is support for both 32 and 64-bit architectures.

Trisquel Edu

Trisquel Edu is a fully free operating system designed for all kinds of educational centers, from primary schools to universities. It is built on the LTS branch of Trisquel, and includes a set of educational packages and classroom management tools.

Educational packages

The default installation comes with the GNOME desktop and very few user applications, making it easier for the teacher to have the exact set of programs needed for the students. The programs can be easily installed using a graphical application that includes the following educational bundles:

  • Image and design
    • Gimp - Bitmap Image editor
    • Inkscape - Vector image editor
    • Scribus - Publishing tool
    • Dia - All purpose diagram tool
    • Xsane - Scan utility
  • Text and HTML
    • Emacs - Advanced editor
    • Screem - HTML editor
    • Scribus - Publishing tool
    • Gobby - Collaborative text editing
    • Lyx - TeX document editor

Management tools

The main Management tools included in Trisquel Edu are iTALC and LTSP.

iTALC - Intelligent Teaching And Learning with Computers

iTALC is a classroom control tool that allows the teacher to remotely view the display of every student in a handy grid. The teacher can interact with the displays (which are updated in real time) in many ways, like remote control, locking, remote program execution, etc. It can also be used to display the selected user screen with a projector, or broadcast it to the other students' monitors.

LTSP - Linux Terminal Server Project

LTSP is a thin-client environment, composed by a computer (or a set of computers) serving a network-bootable GNU/Linux image, and a set of thin clients that will load the image from the server using pxe. The image consists in a minimal client capable of starting a remote X11 user session against the LTSP server. The thin clients are diskless, as all the data is stored and managed in the server. With all of this, you can get the following advantages:

Easier management: Only one computer needs to be managed, the server. It contains all the users, programs and data files, and the diskless clients have no configuration and thus no maintenance is required. The students can start the session from whichever client. If you install a new program in the server, it is instantly available from every client, and the users do not ever need to restart the session.

Scalability: If you need to connect a large number of clients, a set of servers can be set to work together. Depending of the kind of applications to run, a standard server can be used from 30 to 50 simultaneous clients.

Reusing old computers: You can use any computer from the last 10 years or so as a client, as far as its hardware is supported with GNU/Linux and it is capable of booting with pxe.

Low power consumption: If instead of old computers you choose dedicated hardware, you can get fanless and diskless thin clients that are cold, silent, cheap, easy to maintain, and run with less of 10 watts of power, 1/10 part of a standard CPU unit.

Trisquel Gamer

Hello.

I'm pleased to announce the release of Trisquel-Gamer 3.5RC: a live DVD full of Free Software games; just boot and play!

The project goal is to provide a live DVD full of Free Software games that is playable without the need to install anything. Also, Trisquel Gamer allows saving game data and settings automatically in a USB flash drive: Just connect an USB flash drive after booting the DVD and it will save your data in it. No additional configuration is required.

Trisquel Gamer is completely free software and the Live DVD will only contain free software games with free media licenses. There is a list of the games included in the live DVD.

All the games included in Trisquel Gamer have an article at Libre Game Wiki and Free Gamer. So if you are a fan of those sites you will probably recognize all the games included.

Trisquel Gamer 3.5RC is now available here. There are also pages for the list of changes and the system requirements.

Please remember that this is a release candidate and it is likely that it will have bugs, so please be patient.

If you are familiar with GNU/Linux distributions on a live DVD, I'm pretty sure there will be no problem figuring Trisquel Gamer 3.5RC out.

I hope you find it enjoyable.

Regards,

David Zaragoza

Changelog

Update - Saturday February 20th, 2010: This page list the changes made for the current release Trisquel Gamer 2010-2-16.

Update - Tuesday February 16th, 2010: All the task planned for the next release are done. A new release is imminent. I'm in talks with the Trisquel developers to add Trisquel Gamer as a community maintained edition of Trisquel. If so, the next release will be hosted at the Trisquel servers.

Update - Sunday February 14th, 2010: The "Added games" list was changed to "Complete game list" to avoid confusion.

Update - Wednesday February 10th, 2010:

 * Updated the game list, now with 50 games, this is the final list for the next release.
 * The graphical interface for the 'Insert an USB flash drive' message is done.
 * Working on the application's menu.
Monday, February 8th, 2010.

Introduction

Here is the list of games and other features that will be added to the next release of Trisquel Gamer 2010-2-16.

Current release: 18 Games.

Next Release: 50 Games.

I'll make the new release soon, probably this weekend or the next week.

Complete Game List (Updated, Final)

I read a lot of feedback from the Trisquel forum http://trisquel.info/gl/forum/trisquel-gamer-live-dvd-full-free-software-games-boot-and-play, thank you for your comments! So here is the games that will be added to the next release (there are 33 new games):

Name Genre Clones Libre Game Wiki Entry Free Gamer Entry
Abe's Amazing Adventure Platform Link Link
Adonthell (Waste's edge) RPG Link Link
Advanced Strategic Command Turn-Based Strategy Link Link
Armagetron Advanced Racing Tron Link Link
Atomic Tanks Turn-based Strategy Artillery Link Link
Barrage Arcade Link Link
Battle for Wesnoth Turn-Based Strategy Master of Monsters Link Link
Battle Tanks Arcade Link Link
Biniax 2 Puzzle Link Link
Blob Wars Episode 2 : Blob And Conquer Third Person Shooter Link Link
Block Attack Puzzle Tetris Attack Link Link
Bos Wars Real-Time Strategy Link Link
Bygfoot Simulation Link Link
Chromium B.S.U. Arcade Raptor Link Link
Crimson Fields Turn-Based Strategy Link Link
Cultivation Real-time Strategy Link Link
Emilia Pinball Arcade Link Link
Extreme Tux Racer Racing Link Link
Fish Fillets NG Puzzle Sokoban Link Link
Freeciv Turn-Based Strategy Civilization Link Link
Freecol Turn-Based Strategy Colonization Link Link
Frets on Fire Music Guitar Hero Link Link
Freedroid RPG RPG Link Link
Frozen Bubble Puzzle Puzzle Bobble Link Link
GL-117 Combat Flight Simulator Link Link
Globulation 2 Real-Time Strategy Link Link
Hex-a-Hop Puzzle Link Link
LinCity-NG City Building SimCity Link Link
LordsAWar Turn-Based Strategy Warlods II Link Link
Meritous Action RPG Link Link
Neverball Puzzle Super Monkey Ball Link Link
Nexuiz First Person Shooter Link Link
Nikwi Platform Nico Tuvla Link Link
OpenArena First Person Shooter Quake III Arena Link Link
Overgod Arcade Link Link
Pingus Puzzle Lemmings Link Link
Name Genre Clones Libre Game Wiki Entry Free Gamer Entry
Scorched 3D Turn-Based Strategy Scorched Earth Link Link
Secret Maryo Chronicles Platform Super Mario World Link Link
Simutrans Transport Infrastructure Transport Tycoon Link Link
Stormbaan Coureur Racing Link Link
Super Transball 2 Arcade ZARA THRUSTA Link Link
Supertux Platform Super Mario Bros. Link Link
SuperTuxKart Racing Super Mario Kart Link Link
The Mana World MMORPG Link Link
TORCS Racing Link Link
Trackballs Arcade Marble Madness Link Link
Vega Strike Space Simulation Elite Link Link
Widelands Turn-Based Strategy Settlers Link Link
Wormux Turn-Based Strategy Worms Link Link
X-Moto Racing Elastomania Link Link

Removed Games

I removed Flightgear until I can compile fgrun or another GUI to launch the game. In the

current state the CLI is needed to select a plane, airport and other options.

Application's menu (Done)

I'm reworking the application's menu to show more nicely the new collection of games.

Add a graphical 'Connect an USB flash drive' message (Done)

I'll add a message box to show the 'Connect an USB flash drive', I hope it will look nicer than

the current gnome console used to display the message.

Well, that's all for now. Stay tuned for more release information.

Included Games

Introduction

This is a list of all the games included in the current release, with links to the games entry in Libre Game Wiki and a review at the Free Gamer blog.

List of Games

Name Genre Clones Libre Game Wiki Entry Free Gamer Entry
Abe's Amazing Adventure Platform Link Link
Adonthell (Waste's edge) RPG Link Link
Advanced Strategic Command Turn-Based Strategy Link Link
Armagetron Advanced Racing Tron Link Link
Atomic Tanks Turn-based Strategy Artillery Link Link
Balazar III RPG Link Link
Barrage Arcade Link Link
Battle for Wesnoth Turn-Based Strategy Master of Monsters Link Link
Battle Tanks Arcade Link Link
Biniax 2 Puzzle Link Link
Blob Wars Episode 1 : Metal Blob Solid Platform Link Link
Blob Wars Episode 2 : Blob And Conquer Third Person Shooter Link Link
Bloboats Racing Link Link
Block Attack Puzzle Tetris Attack Link Link
Bos Wars Real-Time Strategy Link Link
Boson Real-Time Strategy Link Link
Bygfoot Simulation Link Link
Chromium B.S.U. Arcade Raptor Link Link
Crimson Fields Turn-Based Strategy Link Link
Cultivation Real-time Strategy Link Link
Extreme Tux Racer Racing Link Link
Fish Fillets NG Puzzle Sokoban Link Link
Freeciv Turn-Based Strategy Civilization Link Link
Freecol Turn-Based Strategy Colonization Link Link
Frets on Fire Music Guitar Hero Link Link
Freedroid RPG RPG Link Link
Frozen Bubble Puzzle Puzzle Bobble Link Link
GL-117 Combat Flight Simulator Link Link
Globulation 2 Real-Time Strategy Link Link
Hex-a-Hop Puzzle Link Link
LinCity-NG City Building SimCity Link Link
LordsAWar Turn-Based Strategy Warlods II Link Link
Name Genre Clones Libre Game Wiki Entry Free Gamer Entry
Meritous Action RPG Link Link
NetPanzer Real-time Strategy Link Link
Neverball Puzzle Super Monkey Ball Link Link
Nexuiz First Person Shooter Link Link
Nikwi Platform Nico Tuvla Link Link
OpenArena First Person Shooter Quake III Arena Link Link
Overgod Arcade Link Link
Pingus Puzzle Lemmings Link Link
Plee the Bear Platform Link Link
Scorched 3D Turn-Based Strategy Scorched Earth Link Link
Secret Maryo Chronicles Platform Super Mario World Link Link
Simutrans Transport Infrastructure Transport Tycoon Link Link
Stormbaan Coureur Racing Link Link
Super Transball 2 Arcade ZARA THRUSTA Link Link
Supertux Platform Super Mario Bros. Link Link
SuperTuxKart Racing Super Mario Kart Link Link
Teeworlds Platform Link Link
Tennix! Arcade Pong Link Link
The Mana World MMORPG Link Link
TORCS Racing Link Link
Trackballs Arcade Marble Madness Link Link
Vega Strike Space Simulation Elite Link Link
Widelands Real-time Strategy Settlers II Link Link
Wormux Turn-Based Strategy Worms Link Link
X-Moto Racing Elastomania Link Link

Next Release

Thursday, March 11, 2010: Trisquel Gamer 3.5 RC it's available for download at http://devel.trisquel.info/trisquel-gamer/ the changes listed here apply to version 3.5 RC.

Thursday, March 4, 2010.

Introduction

The next release of Trisquel Gamer will be based on Trisquel 3.5, and will have the same version number for consistency.

Right now Trisquel 3.5 is in RC. There will be a Trisquel Gamer DVD based on this RC or the final version soon.

Here is the list of games and other features that will be added to the next release of Trisquel Gamer 3.5

Current release: 50 Games.

Next Release: 57 Games.

Game List (Updated)

I read a lot of feedback from the Trisquel forum http://trisquel.info/gl/forum/trisquel-gamer-live-dvd-full-free-software-games-boot-and-play, thank you for your comments! So here is the games that will be added to the next release (there are 8 new games, highlighted in bold):

Name Genre Clones Libre Game Wiki Entry Free Gamer Entry
Abe's Amazing Adventure Platform Link Link
Adonthell (Waste's edge) RPG Link Link
Advanced Strategic Command Turn-Based Strategy Link Link
Armagetron Advanced Racing Tron Link Link
Atomic Tanks Turn-based Strategy Artillery Link Link
Balazar III RPG Link Link
Barrage Arcade Link Link
Battle for Wesnoth Turn-Based Strategy Master of Monsters Link Link
Battle Tanks Arcade Link Link
Biniax 2 Puzzle Link Link
Blob Wars Episode 1 : Metal Blob Solid Platform Link Link
Blob Wars Episode 2 : Blob And Conquer Third Person Shooter Link Link
Bloboats Racing Link Link
Block Attack Puzzle Tetris Attack Link Link
Bos Wars Real-Time Strategy Link Link
Boson Real-Time Strategy Link Link
Bygfoot Simulation Link Link
Chromium B.S.U. Arcade Raptor Link Link
Crimson Fields Turn-Based Strategy Link Link
Cultivation Real-time Strategy Link Link
Extreme Tux Racer Racing Link Link
Fish Fillets NG Puzzle Sokoban Link Link
Freeciv Turn-Based Strategy Civilization Link Link
Freecol Turn-Based Strategy Colonization Link Link
Frets on Fire Music Guitar Hero Link Link
Freedroid RPG RPG Link Link
Frozen Bubble Puzzle Puzzle Bobble Link Link
GL-117 Combat Flight Simulator Link Link
Globulation 2 Real-Time Strategy Link Link
Hex-a-Hop Puzzle Link Link
LinCity-NG City Building SimCity Link Link
LordsAWar Turn-Based Strategy Warlods II Link Link
Name Genre Clones Libre Game Wiki Entry Free Gamer Entry
Meritous Action RPG Link Link
NetPanzer Real-time Strategy Link Link
Neverball Puzzle Super Monkey Ball Link Link
Nexuiz First Person Shooter Link Link
Nikwi Platform Nico Tuvla Link Link
OpenArena First Person Shooter Quake III Arena Link Link
Overgod Arcade Link Link
Pingus Puzzle Lemmings Link Link
Plee the Bear Platform Link Link
Scorched 3D Turn-Based Strategy Scorched Earth Link Link
Secret Maryo Chronicles Platform Super Mario World Link Link
Simutrans Transport Infrastructure Transport Tycoon Link Link
Stormbaan Coureur Racing Link Link
Super Transball 2 Arcade ZARA THRUSTA Link Link
Supertux Platform Super Mario Bros. Link Link
SuperTuxKart Racing Super Mario Kart Link Link
Teeworlds Platform Link Link
Tennix! Arcade Pong Link Link
The Mana World MMORPG Link Link
TORCS Racing Link Link
Trackballs Arcade Marble Madness Link Link
Vega Strike Space Simulation Elite Link Link
Widelands Real-time Strategy Settlers II Link Link
Wormux Turn-Based Strategy Worms Link Link
X-Moto Racing Elastomania Link Link

Removed Games

Emilia Pinball.

Music files

I noticed that some games didn't have the music files installed. Now that's solved. The games affected are:

Name
Advanced Strategic Command
Battle for Wesnoth
Nexuiz
Secret Maryo Chronicles
The Mana World
Trackballs
Vega Strike

GUI

There have been some more tweaks to the user interface:

  • Removed desktop icons.
  • Removed 'nautilus' and 'abrowser' icons from the panel.
  • Removed some irrelevant functions from the gnome control center.

I'm thinking on switching the default gnome interface to an interface similar to Trisquel mini, or Ubuntu Netbook Remix. It seems more suitable for Trisquel Gamer due it's single application on screen paradigm.

Well, that's all for now. Stay tuned for more release information.

David Zaragoza

System Requirements

Simple

A computer built in 2004 or newer.

Detailed

RAM

256 MB

CPU

AMD Athlon 64 2800+ (1.8 GHz) or Intel Pentium 4 2.40A (2.4 GHz).

Video Card

AMD/ATI Radeon 9200 (32 MB) or Intel 82945G Express.

Others

DVD-ROM drive.

USB flash drive (to store settings and save games).

How Trisquel is made

From the 2.x release onwards, Trisquel is a fully-free Ubuntu-based derivative, so the process for building the distro starts by doing a local mirror of Ubuntu and cleaning it. We update the mirror every night with reprepro and some cron scripts, and then it gets cleaned using a blacklist of non-free packages.

The resultant repository is then used as the real upstream for the development Trisquel mirror, which also includes replacements for some of the removed packages (like the kernel, or pieces that need rebranding) and a set of packages that tune up the distro, and which includes artwork, configs, and metapackages.

To update the system, we just need to sync the devel mirror against the freed Ubuntu one. Then we check that the changes work by updating our own computers, and then we rsync the devel repository with the official one at http://archive.trisquel.info.

http://trisquel.info/files/workflow.png

Our packages

We include three groups of packages:

Building up an ISO image

Trisquel is built using debootstrap, using a script that also installs a metapackage and its dependencies (to build each edition of the distro), compresses it into a squashfs image and builds the .iso using isolinux. The script also applies some changes to the debootstrap directory, to allow it to run in a live environment.

The makedistro script also builds a set of source code DVDs.

A fully free kernel

Trisquel does not include the vanilla Linux kernel you can find at the Linux project servers, but a cleaned up version of Ubuntu's version of the kernel. Both the upstream versions include non-free binary-only firmware files, and also a lot of binary blobs hidden in .c and .h files in the form of huge sequences of numbers. To provide our users with a fully free kernel we use a set of scripts based in the ones from Linux-libre, with some modifications of our own.

We start with the kernel from the Ubuntu repositories (rather than the latest vanilla version, to assure compatibility with the rest of the system), including the modifications done by Ubuntu in the form of a huge patch. We then apply the Linux-libre deblob script for the matching version, and as a final step, the latest Linux-libre script, modified to allow it to be run against older kernels. This step double-checks the code, and also adds the latest Linux-libre features to the package.

As a result of this procedure, we are not only removing the non-free blobs, we also make sure that no piece of the kernel requires a non-free program to work. We also make use of the latest check scripts from Linux-libre, to assure the cleaning of the Ubuntu modifications (which are not managed by the Linux-libre deblob scripts). This often requires checking for false positives such as data tables comprising long lists of numbers, and the addition of extra cleaning procedures to the deblob scripts, if real positives are spotted.

AttachmentSize
workflow.png75.11 KB

How the netinst image is done

The netinst system is a set of initrd and .iso images that can be used to install a Trisquel system by grabbing the needed packages from the network. It can be used as an standalone .iso image, loaded via PXE, or booted from any conventional bootloader. The netinst image is available for the LTS editions, and it is included as an alternative boot menu entry in the LiveCDs.

The netinst or netinstall system is built around the debian-installer set of packages, and the images themselves are built by compiling the debian-installer package. The typical netinst image, in the form of a tiny .iso, consists of a kernel binary and an initrd image. This image is loaded into the system memory and contains the minimal set of tools needed to download the rest of the installer (packaged in udeb files) at runtime. Once downloaded and installed in the minimal ramdisk system, it is able to debootstrap and configure a complete Trisquel system.

A Debian source package usually compiles to a set of udeb packages, which are designed to be used by dpkg and package managers such as apt in standard installations. The debian-installer needs a lighter package system, as it will be run from a minimal system loaded into a ramdisk. Because of this, the source packages that conform the Debian installer set gives us udeb packages upon compiling. Those udeb packages are not listed by apt-cache, as they have their own repository. The source packages for the udeb ones are in the normal repository, though.

To make our netinst image from the Ubuntu upstream source files we need to modify several (but not all) of the debian-installer set of packages, changing references to Ubuntu with the proper Trisquel ones, removing non-free installers, and replacing the repository selector system. This is the list of debian-installer packages we modify:

  • apt-setup: It configures the sources.list of the installed system.
  • base-installer: Debootstraps a Trisquel system from a mirror.
  • choose-mirror: Lists all the official Trisquel archive mirrors.
  • debian-installer: The main package, it builds the install images. The boot logo, GPG key and several text chains are replaced.
  • grub-installer: Installs the bootloader.
  • main-menu: The installer main-menu. References to Ubuntu are replaced.
  • netcfg: It configures the network and sets the system name. The name is changed from Ubuntu to Trisquel.
  • net-retriever: Downloads the required packages. The GPG signing key is replaced with the Trisquel one.

The repository definitions for the debian-installer set can be found here: http://archive.trisquel.info/trisquel/dists/robur/main/debian-installer/

How to help

There are a lot of things you can do to help the Trisquel project, and you do not need programming skills to perform most of them:

Community driven tasks

We get a lot of requests from the users, with ideas that could improve our software. Many of them are very good ideas, but in most cases we just don't have the time to do them. But we can apply your ideas to the distro if you have the time to make them real.

Some examples of requests we cannot fulfill:

If you want to spend some of your time doing such a task, please join the development mailing list, and tell us about your project. We can give you advice, and we will include your work in our project when it is finished.

Logo

Our logo is the triskelion, a Celtic symbol of evolution and wisdom.

Our Trisquel (the Spanish name for this triple spiral form) resembles the Debian logo, as a form of recognition of the distro we originally based our project on.

The base color we use is #004DB1, and the font (which is free software too) is Droid Sans.

http://trisquel.info/files/logo.png

You can download a vectorial .svg file from here, and a bigger .png from here. A vectorial file of the triskelion alone is here.

Copyright, trademark and license

"Trisquel" and the Trisquel logo are registered trademarks owned by Rubén Rodríguez Pérez. Spanish Trademark and patent office, file M 2855910, Niza class 09. http://www.oepm.es

Officially registered image: http://www.oepm.es/imgLoc/marcas/285/M2855910.jpg?

The logo (without the name) is licensed under the terms of the GNU GPL:

    Copyright © 2004 Rubén Rodríguez Pérez
 
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.

Due to trademark concerns, the logo including the name is released under the following license:

    Copyright © 2004 Rubén Rodríguez Pérez
 
    This logo or a modified version may be used by anyone to refer to the
    Trisquel project, but does not indicate endorsement by the project.
 
    We would appreciate that you make the image a link to
    http://trisquel.info/ if you use it on a web page.

Manuals

This section includes a number of how-tos for Trisquel, and user manuals for some of its more important programs.

Rules

Burn Trisquel CD images

To burn a CD image (like the ISO files of the Trisquel discs) from Windows, you can use the option "burn image" of your CD burning program. If you do not have that kind of software, follow these steps:

  1. Download and install Infra Recorder, a free software program to burn CD images.
  2. Insert a CD/DVD into the recorder, and select "do nothing" or "cancel" if any auto-boot message appears.
  3. Open Infra Recorder, and select Write Image.

http://trisquel.info/files/infrarecorder.jpg

  1. Select the CD image that you want to burn, for example "Trisquel-3.0-i686.iso", and click on 'Open'.
  2. Click on 'Ok'.

Be sure to choose a low burn speed to get error-free burning.

How to create a LiveUSB

For those who want to travel with Trisquel in their pockets or install Trisquel in a ultra-portable driveless laptop, or any other use that fits.

1 - Download FUSBi from here.

2- Install the required dependencies, either through Synaptic or Terminal.

Through terminal:

 sudo apt-get install mtools p7zip-full
3 - Insert a USB device on your computer. The USB Device must have at least 1 GB.

4 - Format your USB Device. Don't forget to make backups of it's content first! In case you have something important on it!

5 - Give permission to FUSBi to become an executable file:

http://trisquel.info/files/fusbi_permissions_0.png

6 - Create a ISO image from your Trisquel CD.

7 - Execute FUSBi by double-clicking on it. Input your root password.

8 - On the window that appears, on "Diskimage | ISO", choose the Trisquel ISO image you created, press OK, now just wait for the process to finish and you're ready to go.

http://trisquel.info/files/fusbi_gui.png

Resources

Instalacion de GNU/Linux Desde Dispositivo USB

FUSBi

Install Trisquel

This installation manual is primarily intended for beginning users, and assumes no prior experience with a GNU/Linux operating system.

Download the CD Image

  1. Go here and download an .iso. Trisquel supports only x86 (32-bit) and AMD64 (64-bit) architectures at this time; download the 32-bit version if you wish to be on the safe side.

Burn the .iso

  1. The .iso file can be burned to a CD or DVD, or installed onto a USB stick. Refer to this manual for burning to CD or DVD, or this one for burning to a USB drive.

Booting into the LiveCD/DVD/USB

  1. Restart your computer.
  2. In the first few seconds as the computer boots up, you will see your manufacturer's BIOS splash screen. You must press a key (generally either the ESC, F1, F2, F5, F10, or F12 key) to access a screen that lets you choose to boot from a CD, DVD, or USB drive instead of your hard disk.

http://imgur.com/9cE4q.jpg

  1. Do not be concerned about how long it takes to start up, as booting a system from removable media is far slower than booting it from your hard disk. Choose a language and select the first option ("Try Trisquel without any change to your computer") when the menu appears.
  2. Now you're booted into the graphical LiveCD environment. You can now try out Trisquel without installing it, and with a USB, you can even save changes. When you are ready to install Trisquel onto your hard disk, click the "Install Trisquel" icon on the desktop or via Menu Bar → System → Administration → Install.

Installation

  1. Step 1: Select a language. Click "Forward".
  2. Step 2: Select your time zone and a city that most closely matches your location. These settings can be can be changed later. Click "Forward".
  3. Step 3: Select your keyboard layout. The default layout is probably best.
  4. Step 4: Create a partition for Trisquel to be installed on. You should probably select Ext4, which is an advanced "journaling" file system and currently the state of the art; Ext3 is the previous version of this file system. Ext2 is a legacy version without journaling, so it reads and writes files faster, but is less reliable in the event of a crash or power outage. You should only choose Ext2 if you are comfortable with its technical limitations. XFS is also a good choice, but be aware that XFS partitions cannot be shrunk once they are created.

Additionally, you need to create a separate Linux swap partition. Optimally it is at least one gigabyte, but it is generally wasteful to have more swap space than your amount of RAM.

http://imgur.com/NoPZY.png

  1. Step 5: Enter your real first and last name, and the name of the computer if you wish. Choose a login name and password. This step is crucial. Be certain that your system password has no chance of ever being guessed by anyone. A genuinely strong password is over 10 characters long and will include a combination of upper and lower-case letters with at least one number. It should include no dictionary words. Fluffy1 or playapimp are weak passwords; WodL73ggmiLhjB (don't use this one!) is a very strong password. This page describes a good method for generating unbreakable, easily remembered passwords.
  2. Step 6: ...
  3. Step 7: Confirm all of your settings one last time before proceeding with installation. When you are satisfied, click "Install". Installation will take several minutes. When it is finished, you will be prompted to reboot your computer. After this, the installation media (CD, DVD, or USB drive) no longer needs to be inserted.

Post-Installation

  1. If another operating system was already installed on your system, you will see a bootloader menu called GRUB. Select Trisquel's entry on the list. If you want to change the background or options of the bootloader menu, it can very easily be done with a program called KGrubEditor.
  2. Log in with your username and password.
  3. Because Trisquel includes only free software, some hardware devices do not work because they rely on proprietary drivers. The two most common hardware-related issues after installation are lack of 3D acceleration and lack of wireless networking. To resolve those two common issues, refer to this guide for graphics and purchase a wireless networking device from this list. Also, you should refer to this list of known hardware that works with fully free systems.
  4. You will likely want to enable DVD playback. The necessary library, libdvdcss2, is left out of the default installation to avoid patent issues. This guide provides instructions to install it in a few seconds.
  5. Welcome to Trisquel GNU/Linux!

Full Disk encryption install

Introduction

We will install Trisquel in an encrypted hard drive:
  • swap will be encrypted
  • root (/) will be encrypted
  • boot (/boot) cannot be encrypted but could be on an USB key or non-re-writable CD-ROM (not covered here)

Instructions

  • Boot the LiveCD
  • Connect to the network using NetworkManager (located on the far-right side of the Panel)
  • Open the terminal and become root:

 sudo su
  • Install cryptsetup and gparted:

 apt-get update
 apt-get install gparted
 apt-get install cryptsetup
  • Launch gparted and partition your hard disk like you would do normally (so create filesystem on the partition etc...) creating unencrypted valid partitions

  • Use Wikipedia to find the best block cypher around. I used aes,xts,essiv:256
  • Load the modules of the chosen encryption:

 modprobe xts
 modprobe aes_i586
 modprobe sha256
Note that I aes_i586 is an optimized version of aes for i586 or later X86 CPU
  • Format the partition you have chosen for root(/) with cryptsetup:

 cryptsetup -y --cipher aes-xts-essiv:sha256 --key-size 512 luksFormat /dev/PARTITION
replace /dev/PARTITION by your partition. It will overwrite all the data in the partition.

  • Open the partition (replace /dev/PARTITION as needed):

 cryptsetup luksOpen /dev/PARTITION crypto_root
  • Format the partition using the filesystem you want (preferably ext4, or XFS if you don't mind that partitions cannot be shrunk in XFS):

 mkfs.ext3 /dev/mapper/crypto_root
  • Launch the Trisquel installer and proceed to step 4, hard disk partitioning
  • Select manual partitioning, then select your root (/) partition to be /dev/mapper/crypto_root
  • Select your swap and your /boot partitions in the same manner
  • Be careful not to recreate the partition table
  • Proceed with installation. When it finishes, select to continue trying Trisquel. Do not reboot.
  • Mount your root partition and chroot into it:

 mkdir /mnt/root
 mount /dev/mapper/crypto_root /mnt/root
 mount /dev/ /mnt/root/dev -o bind
 chroot /mnt/root mount /proc
 chroot /mnt/root mount /sys
 chroot /mnt/root
  • Create the /etc/crypttab replacing /dev/PARTITION as needed:

 echo "root /dev/disk/by-uuid/$(sudo vol_id --uuid /dev/PARTITION) none luks" >> /etc/crypttab
  • Add the cypher modules you have chosen before to /etc/modules so they load at boot and get included in the initd:

 echo xts >> /etc/initramfs-tools/modules
 echo aes_i586 >> /etc/initramfs-tools/modules
 echo sha256 >> /etc/initramfs-tools/modules
  • Install cryptsetup:

 apt-get update
 apt-get install cryptsetup
  • Rebuild the initrd:

 mount /boot
 update-initramfs -u
  • Exit the chroot and unmount everything:

 exit
 umount /mnt/root/boot
 umount /mnt/root/proc
 umount /mnt/root/dev
 umount /mnt/root/sys
  • Finally, reboot Trisquel. You will be asked for your hard disk encryption password.

Backup Files Quickly and Easily

This manual describes one easy solution to backup and restore files on your computer. It is highly configurable and does not require any use of the command line.

Getting the Program

The program you need is SBackup, also called "Simple Backup and Restore". Either open the Add/Remove Applications wizard or Synaptic Package Manager and search for "sbackup", or open the terminal and type:

 sudo apt-get install sbackup

Setting Backup Properties

Click on "Simple Backup Config" from the System Tools section of your Menu Bar.

General

Recommended Backup will perform a daily backup of your /home,system data held in /etc,/usr/local and /var. It will exclude multimedia files and any files over 100MB. By default this backup will be stored /var/backup.
Custom Backup lets you change a backup schedule, backup schedule, included directories/files, and purging schedule yourself.
Manual Backup is a good option if you do not want the program to back up files automatically.

http://imgur.com/P9EkB.png

Include

Select which directories and files on your system will be backed up.

http://imgur.com/N1XyW.png

Exclude

By default, certain multimedia files (like .ogg, .mp3, and .avi) and any file larger than 100 MB are excluded from backups, to drastically cut down on the time it takes to make backups and the size of backups. Directories listed in the "Paths" and "Regex" sections generally store temporary information that does not need to be backed up.

http://imgur.com/gMrJW.png

Destination

You can store backups either in a default directory in /var/backup, in a custom directory, or on an internet backup server. For maximum security, it is best to back up to a removable storage device (external hard drive or USB drive).

http://imgur.com/lVg7h.png

Time

Here you set your backup schedule.

http://imgur.com/3b4jK.png

Purging

You can enable or disable purging of old and incomplete backups, and choose either a simple cutoff point for old backups or go by a logarithmic schedule.

http://imgur.com/q1Ei1.png

Backup

When you are satisfied with the settings you have chosen, you can initialize a backup manually at any time by pressing the "Backup Now!" button. Otherwise, the program will only backup when scheduled. The backup process will run as a background daemon until it is finished.

Restoring a Backup

Click on "Simple Backup Restore" from the System Tools section of your Menu Bar. Simply choose a backup file, select a folder or individual file to restore, and press the "Restore" button. Your folders and/or files will be synchronized with the contents of the backup archive.

http://imgur.com/KaI0B.png

Configure 2D and 3D Graphics Acceleration

This manual is written for the beginner who wants to setup 2D and 3D performance (for Compiz, games, video playback, etc.) in Trisquel using free software. It covers all major graphics hardware (Intel, NVIDIA, and AMD/ATI).

This manual will need to be updated often as hardware and software changes rapidly. Please contribute to it.

Intel

NVIDIA

ATI

Configure a LTSP server

This manual shows how to install and configure a thin client server LTSP (Linux Terminal Server Project), generally to be used as a classroom environment.

In our example we will use for the server a computer with two Ethernet cards, one connected to the internet and the other to a switch, which will be connected to the thin clients. As a client, you can use any PC or dedicated thin client with a i386 or amd64 processor, if it is capable of booting from PXE.

Installation

Having Trisquel Edu installed and running in our server computer (you can use any Trisquel LTS edition), we open a terminal and install the trisquel-ltsp-server package:

 sudo apt-get install trisquel-ltsp-server
This will install the necessary dependencies, including the dhcp server, which we will need to configure with the following command:
 sudo gedit /etc/default/dhcp3-server
We edit the archive, setting the network interface we have connected to the switch. In our case, it will look like this:
 INTERFACES="eth1"
We configure an static IP for that interface, at Trisquel menu > System > Administration > Network . The IP needs to be in the same range used by the dhcp server, 192.168.0.1 being the recommended value.

If we need to change the IP range or any other dhcp configuration, we edit:

 sudo gedit /etc/ltsp/dhcpd.conf
The default values in this archive are OK, but in our case it will look like this:
 authoritative;
 
 subnet 192.168.0.0 netmask 255.255.255.0 {
     range 192.168.0.20 192.168.0.250;
     option domain-name "trisquel.local";
     option subnet-mask 255.255.255.0;
     option root-path "/opt/ltsp/i386";
     if substring( option vendor-class-identifier, 0, 9 ) = "PXEClient" {
         filename "/ltsp/i386/pxelinux.0";
     } else {
         filename "/ltsp/i386/nbi.img";
     }
 }
Make sure the file /var/lib/tftpboot/ltsp/i386|amd64/pxelinux.cfg/default looks like this:
 DEFAULT vmlinuz ro initrd=initrd.img quiet splash
We need to restart the servers to apply the changes:
 sudo /etc/init.d/dhcp3-server restart
 sudo /etc/init.d/openbsd-inetd restart
Note that there is not needed for the thin clients to have route to internet.

The next step is creating the image the clientes will load. In our case, and as a recommendation for everyone, we will use the i386 arch for the clients.

 sudo ltsp-build-client --arch i386
This process takes a while; when it is finished you can connect the clients to the switch and boot them using pxe (you might need to configure the BIOS to do so).

Some advice

  • Every user session is loaded on the server, so you will need a relatively powerful machine. A gigabit link is recommended between the server and the client switch. It is also a good idea to use fast disks in the server, or even RAID systems, and it is highly recommended to use multiprocessor servers.
  • The first user session to load will consume between 250 and 300MB of RAM, and every next session will use between 50 and 80MB. This can help to calculate the amount of RAM needed for the server, but take in count that it will vary depending of what programs the users will load.
  • The minimal requirements for the clients are 48MB of RAM, and a 200Mhz processor or the i386 (recommended) or amd64 architectures. The recommended values are a 400Mhz processor and 128MB of RAM. The client software has sound support and USB or CD disks will be automatically mounted.

Connect to the #Trisquel IRC channel

The Trisquel project has an official IRC chat channel that anyone can join. This guide will tell you how to quickly connect to the #trisquel channel if you have no previous experience with IRC (Internet Relay Chat).

  1. Start up the XChat program (Menu Bar → Internet → XChat IRC)
  2. Choose a username and nicknames.
  3. Trisquel's channel is hosted on FreeNode, a popular service for free software projects. Choose Freenode from the list and click "Connect".

http://imgur.com/HICae.png

  1. Type /join #trisquel and press Enter. You should be connected in a few moments.
  2. Use the /help command to get a full list of commands, and ask around the channel for any further assistance.

Customizing a Trisquel iso

To customize a Trisquel .iso image, you must first download it and place it in an empty directory. Open a terminal and go to that directory, then follow these steps.

Unpacking

  • Become root. All commands below will be run as root.

 sudo su
  • Create an empty directory and mount the iso on it, then extract the contents:

 mkdir tmp
 mount -o loop trisquel-original.iso tmp
 cp tmp -a src
 umount tmp
  • Extract the squashed image files into casper/filesystem.squashfs:

 mount src/casper/filesystem.squashfs -o loop tmp
 cp tmp -a jail
 umount tmp

The Preseed File

Trisquel comes with a preseed file which allows preloading values into the debconf database. You can find the file at src/preseed/trisquel.seed. The file contains commented examples on the changes it can make, like changing the default locale, setting a static network configuration, or automagically installing an extra set of packages before the live-to disk install process (which you need internet access during the install to do).

If you can achieve all the customization you need by changing this file, you can omit the next step.

Making Changes

Now you have the Trisquel system files in the jail directory, and you can start to apply changes. To install or remove packages, you need to enter the jail using chroot:

 cp /etc/resolv.conf jail/etc
 chroot jail
 mount none /proc -t proc
 apt-get update
 apt-get install package
 echo "" > /etc/resolv.conf
 umount /proc
 exit
If you replaced the kernel or the boot scripts, copy the new kernel binary and initrd image as needed:
 cp jail/boot/vmlinuz-custom src/isolinux/vmlinuz
 cp jail/boot/initrd.img-custom src/isolinux/initrd

Repacking

After your modifications are done, you will need to rebuild the squashfs and .iso images. Install squashfs-tools:

 apt-get install squashfs-tools
  • Compress the jail into the squashfs file, deleting the original one:

 rm src/casper/filesystem.squashfs
 mksquashfs jail src/casper/filesystem.squashfs -nolzma
  • Finally, create a new .iso image:

 mkisofs -D -r -V "My Trisquel modified version" -cache-inodes \
 -J -l -b isolinux/isolinux.bin -c isolinux/boot.cat -no-emul-boot \
 -boot-load-size 4 -boot-info-table -o trisquel-modified.iso src
Please make clear to anyone you distribute your version to that it is not an official Trisquel .iso image. If any non-free software is included, please rename your project and do not use our logo.

Enable DVD Playback

By default, Trisquel is unable to decode and play most DVDs because it lacks a library to bypass the CSS (Content Scramble System) algorithm that protects commercially available DVDs. You will need a simple free software library called libdvdcss2, which bypasses the encryption and includes an API to access DVDs as a block device. Even better, libdvdcss2 ignores region codes.

Getting the Package

  1. Go to URL http://download.videolan.org/pub/libdvdcss/ and download the latest version (currently 1.2.10) in .deb format.
  2. Open the .deb file and click on "Install Package". DVD playback should work immediately.

How to configure ZTE MF626 3G Modem

I will show two methods I've learned of how to do it.

This was tested in Trisquel GNU/Linux Dwyn.

--

Minimum Requirements

kernel linux 2.6.29* or above

You can download recent kernel DEB packages from aligunduz.org, which has 100% FOSS kernel DEBs available:
http://aligunduz.org/gNewSense
I tested only with the 2.6.30.7 version

You must install in that order:

  • linux-headers-2.6*.deb
  • linux-headers-2.6*.deb

xplc
Usually, already included in Trisquel.

wvstreams
Usually, already included in Trisquel.

uniconf
Usually, already included in Trisquel.

wvdial
Usually, already included in Trisquel.

ppp
Usually, already included in Trisquel.

--

  • Install the packages mentioned above, as metioned above.
  • Restart your computer.
  • Insert the modem.
  • Wait until the modem automounts in your Desktop.

--

1º Method

--

  • Eject the modem and wait a few seconds until it's available to connect in the Network Manager panel applet. This if for the modem can switch from Storage to Modem mode.
  • Click on the Network Manager panel applet and select your modem to connect.

--

2º Method

--

Open a Terminal and type:

eject /media/ZTEMODEM

--

Wait 15-20 seconds so the modem can switch from Storage to Modem mode.

--

ls /dev/ttyUSB*

If it is recognized, proceed.

--

sudo su

--

wvdialconf

--

gedit /etc/wvdial.conf

--

Copy and paste this:

[Dialer Defaults]
Init1 = ATZ
Init2 = ATQ0 V1 E1 S0=0 &C1 &D2 +FCLASS=0
Modem Type = Analog Modem
ISDN = 0
New PPPD = yes
Phone = *99#
Modem = /dev/ttyUSB2
Username = *insert your ISP username here*
Stupid Mode = 1
Password = *insert your ISP password here*
Baud = 921600

--

Your ISP DNSs may or may not download automatically during the first connection attempt. In any case, if you know what DNSs your ISP uses, put it on the resolve.conf fife as described below.

gedit /etc/ppp/resolv.conf

--

Copy and paste this:

nameserver *insert your ISP DNS here*
nameserver *insert your ISP secondary DNS here*

--

wvdial

--
Reference
http://www.vivaolinux.com.br/dica/3G-VIVO-ZTE-MF626-Ubuntu-9.04

Installing Trisquel on a server

The howto below is mostly outdated with the new netinstall method. The current recommended method is just using the text mode installer included in the LTS editions, and selecting the linux-image-server kernel image.

The 2.x robur LTS version of Trisquel is a very good choice for a server: it has a 64 bit version -needed for 4GB+ RAM, and recommended for virtualization-, a server-optimized linux-libre kernel, and a Xen linux-libre kernel as well.

We are working in a netinst image, wich will allow you to install a server using a small and handy iso image with a full featured installer which downloads the needed packages from the desired Trisquel mirror. In the meantime, you can use this howto to manually install a clean server environment.

You will need...

  • A Trisquel 2.x CD. Any of them should should do, we recommend you to use a i386 image to build a 32 bit server and a amd64 to build a 64 bit one.
  • A server with compatible hardware. You can use almost any x86/x86_64 server, but take care not to buy parts with no free drivers, as they will not work.
  • Some skills about managing a Debian based server. If you are a newbie, install the edu edition with the included installer and use it as a server -with the desktop environment-.

Starting

Start a Live CD session in your server -we recommend to start in in English-. Open a terminal. All the commands listed below will be run in that terminal.

Partition and format your disk

You can partition a disk in a lot of ways and using different hardware configurations. For the purposes of this howto, we will assume that you are installing Trisquel in a single and empty SATA/SCSI disk with no RAID.

NOTE: We will refer to the disk as /dev/sda

Start the partition manager cfdisk. If you like to start with an empty layout, use this command:

 sudo cfdisk -z
You can partition your disk using the layout of your choice, but we recommend this one:
 DEVICE     MOUNTPOINT   FILESYSTEM    SIZE
 /dev/sda1  /            ext3          5GB
 /dev/sda2  swap         swap          1.5 times the memory size
 /dev/sda3  /tmp         XFS           1GB
 /dev/sda4  /home        XFS           the rest of the disk
Notes:
  • The swap is optional, it will be needed if you want to have suspend-to-disk support.
  • Never use XFS for the partition containing /boot
  • Having /tmp in a partition will keep the server from crashing by fullness.

So, use cfdisk to break the disk into that pieces, and save. Now to format the partitions, use this commands:

 sudo mkswap /dev/sda2
 sudo mkfs.ext3 /dev/sda1
 sudo mkfs.xfs /dev/sda3
 sudo mkfs.xfs /dev/sda4
This is just a example layout, you can use the one that fits your needs.

Mount the disk

Create a mountpoint:
 sudo mkdir /target
Now mount the root (/) partition into /target
 sudo mount /dev/sda1 /target

Install the base system

You will use debootstrap to download and install a trisquel base environment. You will need to update the Live CD apt lists and install it first:

 sudo aptitude update
 sudo aptitude install debootstrap
Some usefull parameters that you can give to debootstrap are the arch (it will use the same as the Live CD if you don't give it one), and the mirror (it defaults to archive.trisquel.info, located in Spain):
 sudo debootstrap --arch=amd64 trisquel /target http://mirror
 # or just:
 sudo debootstrap trisquel /target

Configure the base system

You will need to configure your installation, and the first step is to fill the /target/etc/apt/sources.list file. You can just copy the file from the Live CD or use this contents:

 # Trisquel repositories for supported software and updates
 deb http://archive.trisquel.info/trisquel robur main extras
 deb-src http://archive.trisquel.info/trisquel robur main extras
 deb http://archive.trisquel.info/trisquel robur-updates main extras
 deb-src http://archive.trisquel.info/trisquel robur-updates main extras
 deb http://archive.trisquel.info/trisquel robur-security main extras
 deb-src http://archive.trisquel.info/trisquel robur-security main extras
The backports repo is not recommended in a server. You can replace archive.trisquel.info with the mirror of your choice.

You must now setup the server network, by editing the /target/etc/network/interfaces file:

 gedit /target/etc/network/interfaces
Now enter into the chroot:
 sudo chroot /target
You should now be able to update your apt lists and install packages. This is a list of recommended commands to run:
 # set the server hostname and hosts file
 echo boxname > /etc/hostname
 echo "127.0.0.1 localhost" > /etc/hosts
 echo "127.0.0.1 boxname" > /etc/hosts
 
 # set the root password
 passwd
 
 # mount /proc
 mout none /proc -t proc
 
 # configure the keyboard and timezone
 dpkg-reconfigure console-setup
 dpkg-reconfigure tzdata
 
 # update the apt lists
 aptitude update
 
 # install the trisquel-base package
 aptitude install trisquel-base
 
 # install a linux-libre kernel image and boot loader package
 aptitude install linux-image-server grub
 
 # copy the grub files to /boot and run the grub config updater
 cp /usr/lib/grub/* /boot/grub -a
 update-grub
 
 # If you prefer to have bash instead of dash as default shell, run this:
 dpkg-reconfigure dash
 
 # umount /proc
 umount /proc
 
 # exit the chroot
 exit

Install the boot loader

 sudo grub-install --no-floppy --root-directory=/mnt/target /dev/sda

Edit the fstab

You need to edit the /target/etc/fstab file according to the disk layout you made. This is the fstab file that matches our suggested selections:

 #<file system> <mount point>   3860    3861       3862  3863
  proc          /proc           proc      defaults        0       0
  /dev/sda2     swap            sw        defaults        0       0
  /dev/sda1     /               ext3      relatime        0       1
  /dev/sda3     /tmp            xfs       relatime        0       2
  /dev/sda4     /home           xfs       relatime        0       2
You can now reboot and login into your new Trisquel server!

What to do next?

Your new server is an empty shell. You will need to install whatever you need in your box. Here you have some suggestions:

Install a Xen environment

This is an easy one, you just need to add a package:
 aptitude install trisquel-server-xen

Build a GLAMP server

To serve web pages, the most common web server is apache. If you don't need php or a database, just type this:

 aptitude install apache2
To get a complete GLAMP (GNU/Linux Apache MySQL PHP) server, use this:
 aptitude install apache2 mysql-server phpmyadmin
That will install all the needed dependencies, and will also allow you to manage your database by login into http://localhost/phpmyadmin

Play Videos Without Using Flash

The Trouble with Adobe Flash

Adobe Flash is used to deliver the bulk of the video, advertisement, and browser-based game content on the internet. Unfortunately, both the SWF format itself and the decoder that Adobe releases is entirely proprietary; in short, Adobe's market share is more important to them than their potential to make the internet a better place for openness and cooperation. Fortunately, for those of us that consciously value our freedoms, other alternatives exist.

There are two free software Flash players:

  • Swfdec, which has good compatibility but abruptly ceased to be developed sometime in early 2009.
  • Gnash, the GNU SWF player, which is being rapidly developed and relies on the gstreamer and ffmpeg backends to perform. It has good compatibility up to SWF 8 and 9.

YouTube

The video-sharing phenomenon that is YouTube started in 2005 and took the world wide web by storm almost overnight. To the dismay of Free Software users everywhere, use of SWF became unavoidable. The following year, Google Inc. bought the service and has owned it ever since. In 2010, Google started an opt-in experiment to view videos with the new HTML5 specification as an alternative to Flash. Unfortunately, the format they have chosen is the closed, patent-encumbered H.264, not an open, royalty-free format like Theora. Contrary to Google's rhetoric, this decision has nothing to do with the technical capabilities of the Theora format, and everything to do with Google's promoting their own proprietary Chrome browser.

The latest versions of both Gnash and Swfdec should be able to play YouTube videos with good performance. However, users have reported that some YouTube videos refuse to play at all while others work just fine. There is a fallback solution available if you experience such an issue:

  1. Download the free software Greasemonkey add-on for the browser.
  2. Get the "YouTube Perfect" script for Greasemonkey, and also the embedded version.
  3. Now you can view any YouTube video as an MP4 video.

Watching a video without Flash using the YouTube Perfect script

Dailymotion

Dailymotion is another popular video sharing website. They launched around the same time as YouTube although never quite reached the same level of success.

In 2009 Dailymotion did something wonderful for Free Software by opening an alternative HTML5 portal to the website and converting many of their videos to Theora format.

Although Dailymotion is to be commended for this decision, there are still several problems that we should not turn a blind eye to:

  • Hundreds of thousands of videos are available in Theora format right now, especially the very popular ones, but many more videos have not been re-encoded and are Flash-only.
  • You have to be a MotionMaker (a certified uploader of original content) to even have the option of uploading videos as HTML5.
  • Dailymotion does not advertise this portal very well. Someone could potentially use Dailymotion for a long time and never know the Theora portal exists.

How You Can Help

  • Use free alternatives to Flash whenever and wherever you can.
  • Let your friends know that most of the videos and games on the web rely on a single company's closed standard to work, and why this is bad for an open and cooperative vision of the internet.
  • If you develop online games, don't use Flash. Use a free platform such as OpenJDK Java to deliver content inside the browser, and please share your source code.
  • Adobe has a poor track record with freedom, and it isn't going to change its policies overnight. If our community can eventually convince Adobe to make some concessions, such as publicly documenting the SWF standard, or releasing the source code at least for the GNU/Linux version of its Flash player, it would improve the situation greatly.

Setup a Printer

Checking for Compatibility

Look up your printer manufacturer and model at http://www.openprinting.org/printers and see which drivers your printer requires and how it performs. Be careful, because some of the printers in this database require proprietary software to run.

Setup

  1. Install the driver for your printer. Some common drivers like HPLIP and Ghostscript are already in Trisquel's default installation. Open the default printing manager in the Menu Bar (System → Administration → Printing).
  2. Connect your printer to your computer.
  3. The printer should be detected and show up momentarily.

http://imgur.com/V6ibH.png

Configuration

  1. Open the Printer Properties menu by right-clicking on the printer you have connected and clicking "Properties".
  1. In the "Policies" section, check the "Enabled" and "Accepting Jobs" checkboxes, and "Shared" if you want to share the printer over a network.
  2. In the "Access Control" section, you can allow or deny access to other users.
  3. In the "Printer Options" section, the default settings are probably best, but if you want to conserve ink, you can change the default printout mode from "Normal" (color or grayscale) to "Draft".
  4. The "Job Options" section lets you change how your printer handles print jobs. It is generally best to keep the default settings.
  5. Finally, click the "Print Test Page" button under the "Settings" section to get a test page.

Getting Your Cartridge Levels

You will likely want to be able to check your remaining ink/toner levels. There are several easy ways to do this. The easiest method is to use the "Ink/Toner Levels" section of the Printer Properties, but not all printers will report their ink levels correctly (if at all). Another alternative is a graphical tool called Inkblot.
  1. Go to this URL and check if your printer model (it must be a Canon, Epson, or HP printer, currently) is supported by libinklevel, the library used by Inkblot. This library is quite sophisticated, so chances are good that as long as your printer is not on the "unsupported" list, your ink levels will be correctly reported anyway.
  2. Install Inkblot with the Add/Remove Applications tool, or by simply typing sudo apt-get install inkblot in the terminal.
  3. Open the program, located in your Menu Bar (System Tools → Inkblot). It will show up in your panel.
  4. Double-click the icon. Your black and color cartridge levels will be displayed.

http://imgur.com/7nCXb.png

Next release roadmap

Packages to add

Working with repository

Packages to adapt

Browser

Features

Packages repository

Until version 2.0, Trisquel used Debian Stable as the base for its development, using only the main branch packages, which are free of proprietary software. In 2008 we started the development of version 2.0, based on Ubuntu LTS. Because Ubuntu includes proprietary software in its main repository (despite its own admissions that it does not), Trisquel has its own repositories which only include free software.

The apt's configuration for Trisquel 2.0 is the following:

 deb http://archive.trisquel.info/trisquel robur main extras
 deb-src http://archive.trisquel.info/trisquel robur main extras
 deb http://archive.trisquel.info/trisquel robur-updates main extras
 deb-src http://archive.trisquel.info/trisquel robur-updates main extras
 deb http://archive.trisquel.info/trisquel robur-security main extras
 deb-src http://archive.trisquel.info/trisquel robur-security main extras
 deb http://archive.trisquel.info/trisquel robur-backports main extras
 deb-src http://archive.trisquel.info/trisquel robur-backports main extras
The apt's configuration for Trisquel 3.0 is the following:
 deb http://archive.trisquel.info/trisquel dwyn main extras
 deb-src http://archive.trisquel.info/trisquel dwyn main extras
 deb http://archive.trisquel.info/trisquel dwyn-updates main extras
 deb-src http://archive.trisquel.info/trisquel dwyn-updates main extras
 deb http://archive.trisquel.info/trisquel dwyn-security main extras
 deb-src http://archive.trisquel.info/trisquel dwyn-security main extras
 deb http://archive.trisquel.info/trisquel dwyn-backports main extras
 deb-src http://archive.trisquel.info/trisquel dwyn-backports main extras
The branch main includes pre-installed packages of the different versions, and the extras branch includes all the free software available in the Ubuntu repositories, with some additions. The repository has packages for the i386 and amd64 architectures.

Mirrors

Universidade de A Coruña

This is the first official distro mirror, maintained by Oficina de Software Libre of the Universidade de A Coruña.

The ISO images are hosted in http://ftp.udc.es/mirror/trisquel-iso/

This is the apt's configuration for the 2.x branch:
 deb http://ftp.udc.es/mirror/trisquel robur main extras
 deb-src http://ftp.udc.es/mirror/trisquel robur main extras
 deb http://ftp.udc.es/mirror/trisquel robur-updates main extras
 deb-src http://ftp.udc.es/mirror/trisquel robur-updates main extras
 deb http://ftp.udc.es/mirror/trisquel robur-security main extras
 deb-src http://ftp.udc.es/mirror/trisquel robur-security main extras
 deb http://ftp.udc.es/mirror/trisquel robur-backports main extras
 deb-src http://ftp.udc.es/mirror/trisquel robur-backports main extras
This is the apt's configuration for the 3.x branch:
 deb http://ftp.udc.es/mirror/trisquel dwyn main extras
 deb-src http://ftp.udc.es/mirror/trisquel dwyn main extras
 deb http://ftp.udc.es/mirror/trisquel dwyn-updates main extras
 deb-src http://ftp.udc.es/mirror/trisquel dwyn-updates main extras
 deb http://ftp.udc.es/mirror/trisquel dwyn-security main extras
 deb-src http://ftp.udc.es/mirror/trisquel dwyn-security main extras
 deb http://ftp.udc.es/mirror/trisquel dwyn-backports main extras
 deb-src http://ftp.udc.es/mirror/trisquel dwyn-backports main extras

Sandbox

Hey, you can use this page to test the syntax of the wiki!

Third party resources

All the following resources are provided by third party contributors. The Trisquel team is not responsible for the content of other web sites, or how up-to-date their content is.

Downloads

This is a list of third party downloads related to Trisquel.

Blogs

Misc

Web Browser

This is the support and resources repository for the Trisquel web browser, a rebranded release of the Mozilla Firefox browser that never recommends non-free software.

The default browser gets bugfix and stability updates within each individual release of Trisquel, and only receives feature updates (3.5.7 → 3.6 etc.) when the next version of Trisquel releases. If you want a rebranded Firefox that always updates to the latest release, you can try IceCat, which has been included in the repository since Trisquel Awen.

Add-ons

This is a list of free software extensions, themes and translations for the browser. It is a work in progress, and we need volunteers to add and maintain content.

Extensions

Name Summary License
Adblock Plus Blocks ads in web pages. MPL 1.1
Adblock Plus element hiding helper Makes creating element hiding rules for Adblock Plus easier. MPL 1.1
Add to Search Bar Add any page's search functionality to your search bar. MPL 1.1/GPLv2+/LGPLv2.1+
Add Bookmark Here 2 Lets you to add 'Add New Bookmark' to the Bookmarks Toolbar. GPL (generic)
After the Deadline An intelligent grammar, style, and spell-checker. GPLv2
All-in-One Sidebar Extend the functionality of the sidebar. MPL 1.1/GPLv2/LGPLv2.1
AutoProxy Manage and automatically use your proxy. MPL 1.1
Better Amazon Add useful extra features to Amazon. GPLv2
Better Flickr Add useful extra features to Flickr. GPLv2
Better Gmail 2 Add useful extra features to Gmail. GPLv2
Better GReader Add useful extra features to Google Reader. GPLv2
Better iGoogle! Improve the RSS feeds and options of your iGoogle page. MPL 1.1
Better YouTube Add useful extra features to YouTube. GPLv2
Brief A lightweight yet powerful feed reader extension. MPL 1.1
CS Lite Easily control cookie permissions. GPLv2
Cert Viewer Plus Extends the certificate viewer dialog with additional options. MPL 1.1/GPLv2/LGPLv2.1
ChatZilla A full-featured IRC client. MPL 1.1/GPLv2/LGPLv2.1
CheckFox Enables quick check/uncheck of checkboxes. BSD (3-clause)
CheckPlaces Checks if your bookmarks are valid, and finds duplicates of folders. Also restores favicons. MPL 1.1/GPLv2/LGPLv2.1
ColorZilla Graphical color picker tool. MPL 1.1/GPLv2/LGPLv2.1
Compact Menu 2 Save room by compressing the menubar into a single icon. MPL 1.1
Console² Replaces the Javascript Console with a next-generation Error Console. MPL 1.1/GPLv2/LGPLv2.1
CookieCuller Keep the cookies you want, automatically delete the rest. MPL 1.1
CopyAllUrls Copies and pastes all urls of open tabs to and from the clipboard. MPL 1.1/GPLv2/LGPLv2.1
Define Find a definition of highlighted text in Google. GPLv3
DictsInfo Find a definition of highlighted text in Dicts.info. GPLv3
Download Manager Tweak Adds extra features to the default downloader. MPL 1.1/GPLv2/LGPLv2.1
Download Statusbar View and manage downloads from a tiny statusbar. MPL 1.1/GPLv2/LGPLv2.1
DownloadThemAll! An advanced download manager inside your browser. MPL 1.1/GPLv2/LGPLv2.1
dragdropupload Upload files simply by dragging and dropping. MPL 1.1/GPLv2/LGPLv2.1
Dummy Lipsum Generates "Lorem Ipsum" dummy text taken from the Lorem Ipsum website. GPLv3
Duplicate Tab Upload files simply by dragging and dropping. MPL 1.1/GPLv2/LGPLv2.1
Extended Statusbar Add additional website information to the statusbar. MPL 1.1
Extension List Dumper Adds a button to the Add-ons window that shows information about your add-ons in a text format. GPLv3
FEBE Quickly and easily backup your extensions. MPL 1.1
Fangs Renders a text version of a web page similar to screen reader output. GPLv2+
Find In Tabs Searches for text in all tabs. GPLv3
FireBible Read the Bible online or offline in many languages. GPLv2
Firebug Puts a wealth of web development tools at your fingertips while you browse. BSD (3-clause)
Firefogg Encode and upload video in Ogg format. GPLv3
Firefox Showcase Manage and view your browser tabs as thumbnails. MPL 1.1/GPLv2/LGPLv2.1
FireFTP A free, secure, cross-platform FTP client. MPL 1.1/GPLv2/LGPLv2.1
FireGestures A customizable mouse gesture extension. MPL 1.1/GPLv2/LGPLv2.1
FireGPG Provides an integrated interface to apply GnuPG operations to any web page. MPL 1.1
Firemacs Adds some GNU Emacs-like key bindings. BSD
Fission Combines the address bar and the progress bar. MPL 1.1/GPLv2/LGPLv2.1
Flashblock Disable's Flash's autoplay. MPL 1.1/GPLv2/LGPLv2.1
FlashGot A mass downloader with browser integration for many popular download managers. GPLv2
FlipClock A stylized, customizable clock in your statusbar. GPLv2
Font Finder Get the CSS information of any text on the page. GPLv3
FoxClocks View world times in your statusbar or any toolbar. GPLv2
FoxyProxy Basic A simple on/off proxy switcher. GPLv2
... ... ...
FoxyProxy Standard A set of proxy management tools. GPLv2
Google Reader Watcher Checks your feeds regularly notifies you of feeds that have unread news. GPLv2
Greasefire Automatically find Greasemonkey scripts on userscripts.org. GPLv2
Greasemonkey Allows you to customize the way webpages look and function using scripts. MIT
gTranslate Translate any text in a webpage just by selecting and right-clicking over it. MPL 1.1
Header Spy Shows HTTP headers on the statusbar. GPLv3
HTML Validator Finds HTML errors in a web page. MPL 1.1
HTTPFox Monitors and analyzes all incoming and outgoing HTTP traffic between the browser and the servers. GPLv2
ImageTweak Zoom images and display them on a custom background. GPLv3
Image Zoom Customizable image zoom and rotation. GPLv2
ImgLikeOpera Selectively block images on web pages. MPL 1.1/GPLv2/LGPLv2.1
InfoLister Lists installed add-ons (extensions, themes, plugins). MPL 1.1/GPLv2/LGPLv2.1
InFormEnter Adds an icon next to any input field, which you can use to insert any text item with no typing required. MPL 1.1/GPLv2/LGPLv2.1
It's All Text! Edit text fields using the external editor of your choice. GPLv3
JavaScript Deobfuscator View the JavaScript of a web page, even obfuscated scripts. MPL 1.1
JSView Allows you to view the source of JavaScript and CSS files. GPLv2+
KitaDic Simply move your mouse over any English word and hold CTRL to get its definition from Wiktionary. GPLv2
Launchy Open pages, links, files, and view source with external applications. MPL 1.1/GPLv2/LGPLv2.1
LeechBlock Simple productivity tool that blocks time-wasting websites. MPL 1.1/GPLv2/LGPLv2.1
Link Evaluator Helps users evaluate the availability of online resources linked to from a given Web page. Apache 2.0
Linkification Converts text into clickable links. GPLv2
Live HTTP Headers View the HTTP headers of a page. GPLv2+
Locationbar² In the location bar, emphasizes the domain name to reduce spoofing and linkifies URL segments. MPL 1.1/GPLv2/LGPLv2.1
Manage Folders Places a "Manage Folder" item on the context menu of bookmark folders. MPL 1.1
MediaPlayerConnectivity Open browser videos, audio, playlists, and metafiles in any external application. MPL 1.1
Mozilla Labs - Weave Sync Synchronize your bookmarks, history, form data, passwords, and preferences to Mozilla's server. MPL 1.1/GPLv2/LGPLv2.1
OptimizeGoogle Enhance Google search results and remove ads and spam. GPL (generic)
Operator Adds the ability to interact with semantic data on web pages using submenus. MPL 1.1/GPLv2/LGPLv2.1
Pixel Perfect Firebug-dependent; allows web designers to easily overlay web compositions over developed HTML. MPL 1.1/GPLv2/LGPLv2.1
QuickJava Quickly enable and disable Javascript, Flash, Silverlight, and images from the statusbar/toolbar. MPL 1.1
Simple Timer A timer/clock residing in the statusbar or any toolbar. MPL 1.1
Single Key Tab Switch Switch between tabs using hotkeys. MIT
Tabberwocky Lightweight tab browsing extension with numerous features. GPLv3
Table2Clipboard Copu HTML tables to clipboard correctly formatted. GPLv2
Tab Utilities Adds many options to customize the functionality of tabs. MPL 1.1
Tab Utilities Lite A lite version of the Tab Utilities extension. MPL 1.1
Text Link Allows text in webpages to be clicked as URL links. MPL 1.1/GPLv2/LGPLv2.1
Total Validator An all-in-one web page validator and screenshot utility. MPL 1.1/GPLv2/LGPLv2.1
URL Link Open plain text as a URL link. MPL 1.1
View Source Chart View page sources in chart form. GPLv2+
ViewSourceWith View page source with an external application, images with your preferred editor, etc. LGPLv2.1

Themes

Note: Thousands of themes can be viewed and applied effortlessly with the Personas extension. This list only includes the themes that do not rely on Personas for Firefox.

Translations

The primary maintainer of this list is AndrewT. Please notify me of new free add-ons to add, proprietary add-ons on this list, changes in version compatibility, etc.

Template

This template should be used when adding a new page for a browser add-on. New add-on pages should always be created as child pages in the dump.

The template

Install extension

Author: List authors/company and hyperlink to official web page

License: [GPLv2, GPLv3, BSD-like, MPL 1.1, Mozilla Tri-License, etc.]

Works with: [Compatible versions of the browser]

Source code: direct URL link to either a source code download or the source repository



This paragraph will describe the function of the add-on, in italics.

Screenshots


http://imgur.com/jWbPt.png

dump

Adblock plus

Install extension

Author: Wladimir Palant

License: MPL 1.1

Works with: 3.0 – current

Source code: Download



Ever been annoyed by all those ads and banners on the internet that often take longer to download than everything else on the page? Install Adblock Plus now and get rid of them.

Screenshots


https://addons.mozilla.org/en-US/firefox/images/p/13533/1228160822.png



https://addons.mozilla.org/en-US/firefox/images/p/13531/1177025319.png



https://addons.mozilla.org/en-US/firefox/images/p/13535/1228160822.png