jump to navigation

FullPageOS – Out-Of-The-Box Kiosk mode for the RaspberryPi October 17, 2015

Posted by GuySoft in linux, open source, programming.
Tags: , , , , ,
trackback
FullPageOS

FullPageOS

Hey all,

Today I am announcing a RaspberryPi operating system that addresses a small need we have – Get the RaspberryPi to display a webpage on full screen with no hassle.
The OS is called FullPageOS. And you can download it here.

Why I built it

A friend of mine, Tailor Vijay wanted something to stream video and add titles to it. Also I was looking for a way to start the RaspberryPi with a browser on full screen for a stats screen at work, and apparently the only thing available is complex guides that only partly work on today’s RaspberryPi.

So what I did last weekend is build a distro based off the code of OctoPi, the 3D printer operating system I built. All this distro does is start Chromium at boot on full screen, with a URL of your choice. The url can be changed conveniently from a text file on the /boot FAT folder. So all you have to do is set the wifi and url via text files, boot, and voilà!
Among the minor tweaking is the elusive setting of disabling the screen from blanking.

How to set it up

What’s nice about FullPageOS is that its simple, no need to install packages, just flash it like any distro, set your wifi and URL settings and boot.

  1. Open the FAT filesystem that is mounted as /boot
    on the pi
  2. Set the URL you want in the file fullpageos.txt
  3. If you need to set up wifi, set your wifi settings with the file fullpageos-network.txt or any way you want are used to on the RaspberryPI
  4. Plug to HDMI display, internet and boot

Known issue with black boarders

On some screens I tried FullPageOS I got a black boarder, to fix this, you need to edit config.txt and uncomment the line:

disable_overscan=1

This fixes the issue.

Contribution is appreciated!

FullPageOS works, but its missing the shiny slickness that OctoPi has today. For example if someone wants help me write a nice default boot page that would be great! The current default url is just the github page. So as usual, pull requests are welcome.
The source works just like an OctoPi build, and as a by product I wanted to show how easy it is to create custom distros for the RaspberryPi using this build method. We could, really, build a universal custom distro system based off these things. There is already a variant system that was ported from OctoPi code.

FullPageOS image can be downloaded here

Thanks

  • Thanks Taior Vijay for inviting me to the Metor hackathon and asking me to set up a webpage in kiosk mode on the Pi.
  • Thank you Doc’s Tech for hosting the image.

Share and enjoy,
Guy

Comments»

1. Jeremy Malcolm - October 19, 2015

Thanks, this would be a good solution for a dedicated Netflix box.

Rick - October 21, 2015

Netflix won’t work on a pi though.

GuySoft - October 21, 2015
2. Justin - November 3, 2015

Handy! We’re trying it out to run a ‘war board’ here in the office to display stats. It would be handy if I could get it to power off/on the monitor/TV on a schedule so it’s not burning away all night! Aside from that, it’s great🙂

GuySoft - November 3, 2015

You can try reading about SPMS.
The command you want is:
xset dpms force off
and
xset dpms force on

Justin - November 24, 2015

Thanks! I ended up updating the firmware of the rpi (sudo rpi-update) and then the “tvservice” command to turn on/off the monitor instead. I did have to use the “chvt” commands to get it to display the full screen site once it came back on though.

We are using a HDMI to DVI adapter.

Off:

tvservice -o

On:

sudo tvservice -p && chvt 1 && sudo chvt 7

3. Alberto - November 10, 2015

Great idea!

I’m sure the image doesn’t need to be 1GB though, heck all of ChromeOS fits on 250 MB.

GuySoft - November 10, 2015
4. Riaan Vermeulen - June 30, 2016

Hi,
Great solution but having some issues. I’m trying to use this in an environment that requires one to access Wifi either using a web login page or using a username and password. The username/password is the preferred option but how can one achieve this in FullpageOS?

GuySoft - June 30, 2016

No way to do this using RaspberryPi that I know. You can try asking on Raspbian

5. Love Aurell - July 29, 2016

Hi, I just tried it out and it works really well. Thanks! Is there any way to hide the tab bar and go pure fullscreen?

GuySoft - July 30, 2016

Yes, please read the documentation on github. You can change the url in /boot/fullpageos.txt

6. Jacob Hamman - August 30, 2016

Thanks for this, looks awesome. I really appreciate the feature to boot into fullscreen, but is there still a way to access the terminal so that I can write programs for the GPIO pins?

GuySoft - August 30, 2016

See this issue, I gave 3 different ways to do it:
https://github.com/guysoft/FullPageOS/issues/23

7. Ivan - September 13, 2016

Hi how do I tweak the refresh rate so it reloads the page every minute

GuySoft - September 13, 2016

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: