loklak apps site http://apps.loklak.org
JavaScript CSS HTML Python CoffeeScript PowerShell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github Fixes #153: Added ISSUE_TEMPLATE and PULL_REQUEST_TEMPLATE May 11, 2017
CountryTweetMap Fixes #302: Changed backend to api.loklak.org (#303) Aug 13, 2017
LQL fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
LoklakWordCloud fixes #312 - Added store listing info for LoklakWordCloud app (#313) Aug 20, 2017
MultiLinePlotter fixes #300 - updated about link (#301) Aug 12, 2017
NMEA fixes #70 : fixed gps tracking app (#143) Apr 20, 2017
TwitterFollowersInsight Fixes #333: Added storelisting info for TwitterFollowersInsight App (#… Aug 30, 2017
WebScraper Code Fix for coala bears (#108) Feb 27, 2017
WorldMoodTracker Fix #254: Cache API response in World Mood Tracker (#259) Jul 18, 2017
accountpermissions fiixes #109 - fixed account apps (#115) Mar 13, 2017
applist Fixed sites display Dec 13, 2016
barchart Code Fix for coala bears (#108) Feb 27, 2017
bin fixes #322 - added script to expose apps on loklak app wall (#323) Aug 27, 2017
boilerplate fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
bubblecharts Code Fix for coala bears (#108) Feb 27, 2017
cms fixes #300 - updated about link (#301) Aug 12, 2017
collegeElections Fixes #302: Changed backend to api.loklak.org (#303) Aug 13, 2017
compareTwitterProfiles Fixes #260: Added more fields to Compare Twitter Profiles App (#261) Jul 20, 2017
css fixes #207 - Fixes top bar height on details page and (#327) Aug 31, 2017
docs fixes #322 - added script to expose apps on loklak app wall (#323) Aug 27, 2017
ducphanduy fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
emojiHeatmap Fixes #266: Added all details of emoji app for store listing (#285) Aug 2, 2017
emojiHeatmapper Fixes #302: Changed backend to api.loklak.org (#303) Aug 13, 2017
fonts Fix #188: Initialized World Mood Tracker app Jun 16, 2017
forgotpassword fiixes #109 - fixed account apps (#115) Mar 13, 2017
fossasia-histogram fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
heatmap Fixes #302: Changed backend to api.loklak.org (#303) Aug 13, 2017
heatmapper Fixes #302: Changed backend to api.loklak.org (#303) Aug 13, 2017
histogram fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
images fixes #306 - Fix icon link in index.html (#307) Aug 16, 2017
js fixes #328 - displayed error for invalid app (#329) Aug 27, 2017
keyRegistration fiixes #109 - fixed account apps (#115) Mar 13, 2017
knowTheDiff fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
loginpage fiixes #109 - fixed account apps (#115) Mar 13, 2017
loklakGoApi fixes #125 - Created a new category for the varous loklak API librari… Jun 20, 2017
loklakJavaApi fixes #125 - Created a new category for the varous loklak API librari… Jun 20, 2017
loklakNodejsApi fixes #125 - Created a new category for the varous loklak API librari… Jun 20, 2017
loklakPythonApi fixes #125 - Created a new category for the varous loklak API librari… Jun 20, 2017
loklakRubyApi fixes #125 - Created a new category for the varous loklak API librari… Jun 20, 2017
movietweets Fixes #302: Changed backend to api.loklak.org (#303) Aug 13, 2017
newyear Code Fix for coala bears (#108) Feb 27, 2017
oneClickDeploy Fixes #316: Added azure one click to one click deploy app (#317) Aug 21, 2017
querybrowser fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
resetpass fiixes #109 - fixed account apps (#115) Mar 13, 2017
sentimentVisualizer fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
signup fiixes #109 - fixed account apps (#115) Mar 13, 2017
social-wall fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
superwoman7 fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
tests fixes #310 - Adding tests for store listing page (#319) Aug 27, 2017
tweetfeed fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
tweetheatmap Fixes #302: Changed backend to api.loklak.org (#303) Aug 13, 2017
tweetsleaderboard fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
userprofile fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
webtweets fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
whatsTrending Fixes #302: Changed backend to api.loklak.org (#303) Aug 13, 2017
yasoob fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
yathannsh fixes #222 - updated app.json of majority of the apps (#223) Jun 30, 2017
.coafile fixes #296 - added download feature to LoklakWordCloud app (#297) Aug 12, 2017
.gitignore fixes #308 - added tests for home page. (#309) Aug 21, 2017
.swp fixes #126 - fixed querybrowser app (#128) Mar 13, 2017
.travis.yml Fixed travis Jan 10, 2017
CNAME html site Dec 7, 2016
LICENSE Initial commit Mar 4, 2015
README.md fixes #337 - Updated README.md (#338) Sep 3, 2017
app_list.js fixes #331 - Handled case when no app matched search (#332) Aug 31, 2017
apps.json Fixes #336: Updated apps.json file (#339) Sep 4, 2017
conf.js fixes #310 - Adding tests for store listing page (#319) Aug 27, 2017
details.html fixes #207 - Fixes top bar height on details page and (#327) Aug 31, 2017
forum.html fixes #182 - created an discussion forum for apps.loklak.org (#183) Jun 14, 2017
index.html fixes #331 - Handled case when no app matched search (#332) Aug 31, 2017
manifest.yml Code Fix for coala bears (#108) Feb 27, 2017
package.json fixes #311 - Added npm command to start development server (#318) Aug 22, 2017
robots.txt html site Dec 7, 2016
travis.yml Create travis.yml Jan 9, 2017

README.md

apps.loklak.org

Build Status Join the chat at https://gitter.im/loklak/loklak Percentage of issues still open Average time to resolve an issue Twitter Twitter Follow

Loklak is a server application which is able to collect messages from various sources, including Twitter. The server contains a search index and a peer-to-peer index sharing interface. All messages are stored in an elasticsearch index. An automatic deployment from the development branch at GitHub is available for testing here https://loklak-server-dev.herokuapp.com

'Lok Lak' is also a very tasty Cambodian stir-fry meat dish (usually beef) with a LOT of fresh black pepper. If you ever have the chance to eat Beef Lok Lak, please try it. I hope not to scare vegetarians with this name, currently I am one as well.

Communication

Please join our mailing list to discuss questions regarding the project: https://groups.google.com/forum/#!forum/opntec-dev

Our chat channel is on Gitter here: https://gitter.im/loklak/loklak

Loklak Applications

Loklak_server is the framework for messages, queries, suggestion, geocoding, accounts and more. These services do not have a graphical front-end, hence this repository houses the apps page, which is a showcase for developers and their applications which use loklak_search. Some of the applications in the repository include-

  • LQL (Loklak Query Language), an advanced search tool for loklak
  • NMEA, a software application for tracking GPS NMEA Data using Loklak and OpenStreetMaps
  • WebScraper, an application which converts web pages into structured data
  • accountpermissions, an accounts operations application using an Accounts API for view permissions
  • barchart, a stacked bar chart using loklak_search and D3 stack layout
  • boilerplate, a 'hello world' loklak app
  • bubblecharts, a bubble chart using D3 pack layout and loklak
  • ducphanduy, a loklak tweet search page using AngularJS
  • forgotpassword, a accounts operations application for password recovery system
  • fossasia-histogram, a tweet analytics application of loklak tweets histogram about FOSSASIA
  • histogram, a message visualiser encompassing a tweet histogram plotter
  • keyRegistration, an accounts operations application for registering a public key
  • knowTheDiff, a software application comparing search and aggregations
  • loginPage, an account operations application to log in to loklak
  • oneClickDeploy, an API to increase loklak peers
  • queryBrowser, a suggestion search listing all queries made in loklak
  • resetpass, an account operations application to reset one's loklak password
  • sentimentVisualiser, a tool for visualising the sentiment of a tweet
  • signup, an account operations application to sign up to loklak
  • social-wall, a loklak API-based twitter social wall
  • superwoman7, a vertical tweet search message timeline
  • susi, a chat with Susi API
  • tweetfeed, a twitter feed using polls with infinite scroll
  • tweetsleaderboard, a leaderboard based on the number of tweets using a Users API
  • userprofile, a user profile visualisation using loklak
  • yasoob, a loklak search page
  • yathannsh, a loklak search page
  • newyear, a page that displays new year tweets using the loklak api
  • CountryTweetMap, an app to plot and compare tweet frequency on map
  • LoklakWordCloud, an app to generate Word Cloud using Loklak
  • MultiLinePlotter, an application to visually compare tweet statistics
  • TwitterFollowersInsight, an application to visually check followers country vice aggregation
  • WorldMoodTracker, an app track mood of people from around the globe
  • collegeElections, an application to conduct and evaluate college Elections
  • compareTwitterProfiles, an application which shows comparison between two twitter profiles
  • emojiHeatmap, an app which shows emoji usage in twitter
  • emojiHeatmapper, an application which shows tweets contatining emoji as Emoji-heatmap and Emoji-map
  • whatsTrending, an applicaton to get top trending hashtags on twitter
  • loklakGoApi, Library for using loklak API from Go
  • loklakJavaApi, Library containing the methods for using loklak API
  • loklakNodejsApi, Library for using loklak API from NodeJs
  • loklakPythonApi, API for python as a replacement for twitter API
  • loklakRubyApi, API wrapper to use loklak API from Ruby

How to create a loklak app

  1. Create your app
  • Make a subdirectory in fossasia/apps.loklak.org/[your-app] folder
  • Add at least three files into this folder, named index.html, app.json and screenshot.png. For an easy quick-start, use and copy the app boilerplate from https://github.com/fossasia/apps.loklak.org/tree/master/boilerplate
  • All libraries, css files, javascript and fonts must be either already existent in loklak or you must add this to your app path as well.
  • The screenshot must be cropped into 640 x 640 pixels and in .png format.
  • The file index.html is the landing page of your app. Use /js/angular.min.js from the loklak root path for your application. The app should make use of the json libraries in /js. If applicable, make use of the bootstrap style from /css.
  • The file app.json must be in json-ld format (see http://json-ld.org/) and must contain the SoftwareApplication object from schema.org: https://schema.org/SoftwareApplication -- just copy-paste an existing app.json from another app to start you own file
  • Modify the field "permissions" in app.json: it must contain a comma-separated list of all api paths, that the app calls. This is used to apply authorization markers to the app, so it becomes visible if the app is actually usable for the user. Examples: "permissions":"/api/suggest.json", or "permissions":"/api/settings.json,/api/account.json"
  • Alternatively, you can use loklakinit tool to automatically create your app directory structure, app.json and initial dummy HTML, CSS, JS and documentation files to quickly get you started with your development work. Learn more about the use of loklakinit tool [here](To know more in details about developing a Loklak app, preparing your app for store listing and updating Loklak app wall with your new app, please follow this tutorial.
  1. Check quality of your app
  • Do a json-ld validation: use https://developers.google.com/structured-data/testing-tool/ to check your app.json
  • Call http://api.loklak.org/api/apps.json to see if your app.json is included in the app list
  • Check if all declarations in your app.json relate to your own app (if you copy-pasted another app.json, you may have forgotten to change some fields)
  • Under Application Category try and choose one of the following Categories: a. Accounts b. Game c. Visualizer d. Scraper e. Search f. Internet of Things
  • List an appropriate Application Sub Category too
  • Check the style and behaviour of your app: don't deliver half-done code.
  • Open your index.html in different browser to check that your code is not browser-specific
  • Add a backlink in your app to /apps/ to make it possible that users can browse from your app to all other apps
  1. Publish your app

To know more in details about developing a Loklak app, preparing your app for store listing and updating Loklak app wall with your new app, please follow this tutorial

How to run Loklak Apps locally

You need to have NodeJS and NPM. To run Loklak Apps locally, follow the next steps

  1. Open apps.loklak.org project directory in terminal
  2. Run npm install
  3. Run npm start
  4. This starts the development server at port 8080. Open browser and visit http://127.0.0.1:8080

How to run tests

Loklak apps site uses jasmine testing framework with protractor for testing. To run the tests follow the steps mentioned below.

  1. Open the project directory in terminal.
  2. Run npm install if you have not already
  3. Run npm run update-driver
  4. Run Loklak apps using npm start
  5. Run npm run start-driver
  6. Finally start tests using npm test

How users will discover your app

The loklak front-end will compute an aggregation of all those app.json descriptions and provide this in /api/apps.json as a list of the single app.json files. A front-end (another app) will provide an overview of the given apps in visual form. This will be linked in the loklak front-end.

Code practices

Please help us follow the best practice to make it easy for the reviewer as well as the contributor. We want to focus on the code quality more than on managing pull request ethics.

  • Single commit per pull request
  • Reference the issue numbers in the commit message. Follow the pattern Fixes #<issue number> <commit message>
  • Follow uniform design practices. The design language must be consistent throughout the app.
  • The pull request will not get merged until and unless the commits are squashed. In case there are multiple commits on the PR, the commit author needs to squash them and not the maintainers cherrypicking and merging squashes.
  • If the PR is related to any front end change, please provide link to a sample deployment of the site with the changes you have made.

What is the software license?

LGPL 2.1

Where can I report bugs and make feature requests?

This project is considered a community work. The development crew consist of YOU too. I am very thankful for pull request. So if you discovered that something can be enhanced, please do it yourself and make a pull request. If you find a bug, please try to fix it. If you report a bug to me I will possibly consider it but at the very end of a giant, always growing heap of work. The best chance for you to get things done is to try it yourself. Our issue tracker is here.