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

Drew - November 22, 2016

There’s no where in the documentation that shows how to hide the tab bar. Can you either direct me to a link how to do this or just say how to here please.

GuySoft - November 22, 2016

Yes, don’t use FullPageDashboard by setting a different url In /boot/fullpageos.txt.
its in the readme, but I really need help writing more explicit documentation. If you feel like explaining what you did in https://github.com/guysoft/FullPageOS/wiki (just write, ill otgamize it)

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
8. Steven - October 6, 2016

Hi, this is just great and exactly what i was looking for… One question though… If i change/update the online presentation, what is the refresh rate of the kiosk or how can this be manipulated/forced?

GuySoft - October 6, 2016

Its a feature we just had no time to work on (people contribution is welcome!).
There are sevral work arounds, see: https://github.com/guysoft/FullPageOS/issues/11

9. Martin - November 16, 2016

Is there a way to just use it without wifi?

And also remove the tabs of the page?

And thanks a lot for developing it! 🙂

GuySoft - November 16, 2016

Yes, thes are both regular behaviors

10. Trab - November 20, 2016

Would this work for web based employment application? I have done all of the hard work that you have put into one simple approach. The problem is access to shortcut keys, etc as the user has to have access to the keyboard to complete the application.

GuySoft - November 20, 2016

You can attach a keyboard to the PI, even aa wireless one😉

11. Ion Bordian - December 5, 2016

Hello, great software😉
We’re trying to show some date/time information on our website, but fullpageos displays the utc value of hours; How can we set the time zone from the configuration files?
Thank you very much!

GuySoft - December 5, 2016

Hey,
Yes, FullpageOS is based on Debian, so you can edit it.
Here is a guide how to do that.
Also you can post issues on the github issue page


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: