{"id":21893696,"url":"https://github.com/asterics/p4allbuildingblocks","last_synced_at":"2025-03-22T03:45:03.961Z","repository":{"id":26739028,"uuid":"30196685","full_name":"asterics/P4AllBuildingBlocks","owner":"asterics","description":"The standalone versions of dedicated AsTeRICS components delivered as Building Blocks for the Prosperity For All project (P4All) ","archived":false,"fork":false,"pushed_at":"2018-01-08T14:51:58.000Z","size":62791,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-03T02:52:49.934Z","etag":null,"topics":["accessibility","assistive-technology","environmental-control","eye-tracking","face-tracking","keyboard-emulation","mouse-emulation","signal-processing","smart-home"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asterics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-02T16:39:59.000Z","updated_at":"2017-08-28T21:19:23.000Z","dependencies_parsed_at":"2022-08-25T12:40:40.334Z","dependency_job_id":null,"html_url":"https://github.com/asterics/P4AllBuildingBlocks","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asterics%2FP4AllBuildingBlocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asterics%2FP4AllBuildingBlocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asterics%2FP4AllBuildingBlocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asterics%2FP4AllBuildingBlocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asterics","download_url":"https://codeload.github.com/asterics/P4AllBuildingBlocks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244902918,"owners_count":20529114,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accessibility","assistive-technology","environmental-control","eye-tracking","face-tracking","keyboard-emulation","mouse-emulation","signal-processing","smart-home"],"created_at":"2024-11-28T13:16:12.629Z","updated_at":"2025-03-22T03:45:03.939Z","avatar_url":"https://github.com/asterics.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# P4AllBuildingBlocks\nThis repository contains 'sub-repositories' with configuration and build files for deploying dedicated AsTeRICS Building Blocks as runnable stand-alone demos. Additionally, the building block demos can be bundled together into one installer. A dedicated deployment tool ([AsTeRICS Packaging Environment, APE](https://github.com/asterics/P4AllBuildingBlocks/wiki/AsTeRICS-Packaging-Environment-(APE))) has been developed for the [Prosperity for All (P4All)](http://www.prosperity4all.eu/\n) project and is used to extract only the needed resources of a full AsTERICS installation to run a building block demo. For more information about customization of Building Blocks and deployments as well as licensing options please have a look a the [Wiki](https://github.com/asterics/P4AllBuildingBlocks/wiki)\n\nA short overview of the features of the building blocks can be found in the [P4All Developer Space listing](http://portal.teco.edu/dspace/?q=en/)\n\n## Screencast\nCheck this screencast explaining and demonstrating the structure and usage of the repository.\n\n\n[![Screencast explaining and demonstrating the structure and usage of the repository](images/Screencast-P4AllBBRepo.PNG)](https://youtu.be/kpM3E7fp_gQ) \n\n## Demos\nGo to the AsTeRICS [demo page](http://asterics.github.io/AsTeRICS/demos.html) to see the building blocks in action.\nThe [demo release](https://github.com/asterics/P4AllBuildingBlocks/releases/tag/asterics-prosperity4all-bb-demos-0.2) of the AsTeRICS system includes runnable versions of all these Building blocks and demo applications of their combination.\n\n## Licenses\nThe building blocks are dual licensed. You can choose between [MIT or GPLv3 with CLASSPATH exception](LICENSE.txt) license depending on the selected set of plugins, services and libraries you want to use. Please read the [license section in the wiki](https://github.com/asterics/P4AllBuildingBlocks/wiki#license) for more information.\n\n## Building the project\nThis repository is organized in thematic subfolders ('sub-repositories') like ```CameraInput``` containing building blocks using a camera (e.g. for facetracking or eyetracking) or demonstrate use cases for a Smart Home environment.\n\nThe building blocks can be used in two ways depending on your requirements:\n\n* Option 1: Create a downstripped/extracted version of AsTeRICS depending on the given model files using [APE-copy](https://github.com/asterics/AsTeRICS/blob/master/bin/APE/README.md). APE-copy is available as a commandline tool  (```APE-copy.sh|APE-copy.bat```) and as a build target (```ant APE-copy```) of the provided ant build infrastructure. You can use the resulting folder and **bundle and deploy it together with your software**.\n\n* Option 2: Create a **native installer** and **native launcher** for your platform of choice. Currently Windows (.msi, .exe), Linux incl. Raspberry Pi (.deb) and Mac OSX (.dmg) are supported. This option is only available as an ant build target (```ant deploy```).\n\nThe behaviour of APE-copy and the native installer creation can be configured in the file [```APE.properties```](APE.properties). There you can define model files, copy modes, application name and version and optionally embed a JRE (Java Runtime Environment) into your installer.   \n\n### Install and build instructions of prerequisites \n\nThe commandline tool APE-copy only needs a Java Runtime Environment. In order to use the ant build targets and create native installers you also need **ant** and a **Java Development Kit 8**.\n\n* Clone the P4AllBuildingBlocks repository\n```\ngit clone https://github.com/asterics/P4AllBuildingBlocks.git\n```\n* Download and install [AsTeRICS v2.8 full installer](https://github.com/asterics/AsTeRICS/releases/download/v2.8/Setup_AsTeRICS_2_8.exe) or the [platform independent zip-file](https://github.com/asterics/AsTeRICS/releases/download/v2.8/asterics-are-ape-2.8.zip) containing ARE and APE. If using the zip-file, extract it to a parallel folder of the P4AllBuildingBlocks repository.\n\n* Install the [**Java Development Kit 8 (32-bit)**] (http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)\n  * Verify the java installation by opening a command shell and entering ```javac -version```. In case of trouble, ensure to set “JAVA_HOME” to the folder where you installed the Java JDK and add the JDK bin path to the Environment Variable “Path”\n* Install the [**apache ant build framework (version \u003e= 1.9.1)**] (http://ant.apache.org/bindownload.cgi)\n  * Ensure to set “ANT_HOME” to the folder where you installed ant and add the ant bin path to the Environment Variable “Path”\n* __Only for option 2__: Install installer-specific toolkits like [InnoSetup \u003e= 5] (http://www.jrsoftware.org/isdl.php) (.exe), [WiX toolset \u003e= 3.0](http://wixtoolset.org/) (.msi) or [debian packaging tools] (https://wiki.debian.org/PackageManagement) (.deb) depending on the required target platform. You must run the installer build process on the target platform of the installer. For more details, read the [JavaFX packaging tutorial] (https://docs.oracle.com/javase/8/docs/technotes/guides/deploy/self-contained-packaging.html#A1324980) \n\n### Creating bundled demo with ant APE-copy\n\n* Open a terminal window in the root folder of the P4AllBuildingBlocks repository and call  \n```ant APE-copy```\n* To test the result, go to the ```build\\merged\\bin\\ARE``` subfolder and start the ARE.  \n```\ncd build\\merged\\bin\\ARE\nstart.bat\n```  \n\n### Creating bundled demo installer (.exe)\nPlease ensure to install [InnoSetup \u003e= 5] (http://www.jrsoftware.org/isdl.php) to be able to create .exe installer files.\n\n* Open a terminal window in the root folder of the P4AllBuildingBlocks repository and call  \n```ant deploy```\n* To test the result, go to the ```build\\deploy\\bundles``` subfolder and execute the demo installer  \n```\ncd build\\deploy\\bundles\nasterics-prosperity4all-bb-demos-0.2.exe\n```\n\nThe demo will be installed to the user home directory and started automatically.\n\n### Creating single camera mouse demo with ant APE-copy\n\n* To build the demo of a single building block, go to the respective subfolder - for the crossplatform camera mouse, this is ```CameraInput\\XFacetrackerLK``` and call ```ant APE-copy```.\n```\ncd CameraInput\\XFacetrackerLK\nant APE-copy\n```\n* To test the result, go to the ```build\\merged\\bin\\ARE``` subfolder and start the ARE.\n```\ncd build\\merged\\bin\\ARE\nstart.bat\n```  \n\n### Creating single camera mouse demo installer\n\n* To create a native installer for a single building block, go to the respective subfolder - for the crossplatform camera mouse, this is ```CameraInput\\XFacetrackerLK``` and call ```ant deploy```.\n* The build process must be run on the target platform of the installer (e.g. Windows for .exe, Debian/Ubuntu for .deb). Also check the [dependencies](https://github.com/asterics/AsTeRICS/blob/master/bin/APE/README.md#dependencies) first.\n```\ncd CameraInput\\XFacetrackerLK\nant deploy\n```\n* To test the result, go to the ```build\\deploy\\bundles``` subfolder and execute the demo installer  \n```\ncd build\\deploy\\bundles\ncameramouse-xfacetrackerlk-p4all-bb-demo-0.2.exe\n```\n\nThe demo will be installed to the user home directory and started automatically.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasterics%2Fp4allbuildingblocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasterics%2Fp4allbuildingblocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasterics%2Fp4allbuildingblocks/lists"}