Skip to content
This repository has been archived by the owner on Nov 18, 2024. It is now read-only.
/ plainsq Public archive

Foursquare v2 client for mobile browsers (Google App Engine / Python version)

License

Notifications You must be signed in to change notification settings

mortonfox/plainsq

Repository files navigation

PlainSquare - Foursquare v2 client for mobile browsers

Introduction

PlainSquare is a lightweight Foursquare client for both mobile and desktop web browsers. It is intended as a full-featured substitute for Foursquare Mobile. PlainSquare supports both geolocation (using device GPS or cellular / wi-fi positioning) and manual coordinate entry for phones without GPS.

PlainSquare speeds up a check-in by making this operation single-click if you do not need to shout or change your broadcast options. PlainSquare is designed to send you through as few screens as possible to do most common Foursquare tasks.

PlainSquare uses OAuth version 2 to log in to Foursquare to avoid having to store user passwords. PlainSquare supports version 2 of the Foursquare API. It is written in Python and designed for hosting on Google App Engine.

Installation

Before you can run PlainSquare, you have to apply for API keys at https://developer.foursquare.com/ Once you have a client ID and client secret, install those into apikeys.yml.

The easiest way to set it up is to run the Google App Engine Launcher and invoke the File / Add Existing Application menu item. Point it at the source code root folder. Then you can run it or deploy it to App Engine.

Demo

See it run at: http://plainsq.appspot.com/

Screenshots

The following screenshots show the mobile (touch-friendly) skin. On a desktop browser, PlainSquare uses ordinary links instead of buttons.

This is the main menu:

Main Menu

This is the "detect location" screen. You have a choice of Google or Bing maps.

Geolocation

Once you have selected a location, PlainSquare displays the nearest venues:

Nearest Venues

Each venue is a link to a screen displaying venue info:

Venue Info 1

including tips and pictures:

Venue Info 2

You can also view notifications:

Notifications

mayorships:

Mayorships

and badges:

Badges

About

Foursquare v2 client for mobile browsers (Google App Engine / Python version)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published