{"id":13527959,"url":"https://github.com/mozilla/chromeless","last_synced_at":"2025-12-16T21:32:30.368Z","repository":{"id":1094868,"uuid":"952058","full_name":"mozilla/chromeless","owner":"mozilla","description":"DEPRECATED - Build desktop applications with web technologies.","archived":true,"fork":false,"pushed_at":"2019-10-15T20:34:14.000Z","size":5991,"stargazers_count":760,"open_issues_count":0,"forks_count":115,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-09-22T18:46:13.979Z","etag":null,"topics":["abandoned","unmaintained"],"latest_commit_sha":null,"homepage":"http://mozillalabs.com/chromeless","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mozilla.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-09-30T18:54:02.000Z","updated_at":"2025-03-15T03:55:09.000Z","dependencies_parsed_at":"2022-07-17T12:16:14.089Z","dependency_job_id":null,"html_url":"https://github.com/mozilla/chromeless","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/mozilla/chromeless","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla%2Fchromeless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla%2Fchromeless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla%2Fchromeless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla%2Fchromeless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mozilla","download_url":"https://codeload.github.com/mozilla/chromeless/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla%2Fchromeless/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278314268,"owners_count":25966771,"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","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["abandoned","unmaintained"],"created_at":"2024-08-01T06:02:08.322Z","updated_at":"2025-10-04T12:30:51.301Z","avatar_url":"https://github.com/mozilla.png","language":"JavaScript","readme":"## Welcome To Chromeless!\n\nThe 'chromeless' project is an experiment into making it possible to build\na web browser using only web technologies, like HTML, JavaScript, and CSS.\n\nThe project is based on [addon-sdk (aka,\n\"jetpack\")](http://github.com/mozilla/addon-sdk), and\n[xulrunner](https://developer.mozilla.org/en/xulrunner).\n\n## Current State\n\nThis project is *highly* experimental, rapidly changing, and probably\ninsecure.  As the project matures, this notice will change.\n\n## Design Overview\n\nChromeless can be used to created desktop applications using HTML, \nand related web technologies. In version 0.1, the original goal was a focus \ntowards authoring a browser-like applications in HTML. That is still valid, however, \nnow you can also use Chromeless to create all sorts of apps that can be executed like \n a native application, but where all of the look and feel, and many of the\nbehaviors are defined by HTML, CSS, and javascript provided by the developer.\n\nThis \"main app HTML\" is basically a normal webpage, but with several important differences:\n\n  * The HTML file has access to a 'window.require()' function that it can use to\n    access new APIs that give it increased priviledges.\n\n  * (untrusted) Web content can be rendered inside iframes which are children of the\n    top level \"main app HTML\".  This content cannot tell its rendered inside an iframe,\n    and has no special access to the main app context.\n\n  * Several new events and conventions are introduced.  For instance, the title of the\n    top level browser HTML is the name of the running process (not yet implemented),\n    new, non-standard events are available to the top level browser HTML which give it\n    a priviledged view (and control) over embedded web content.\n\n## Prerequisites\n\n* OSX 10.5 and later, Windows XP and later, or probably a modern versions of linux (32 or 64 bit).\n* Python 2.5 - 2.7 (3 is not supported); Python 2.6 or 2.7 are recommended (testing isn't as thorough with 2.5).\n\n## Getting Started\n\nThe top level `chromeless` python script is capable of several things:\n\n  * running a browser when provided a path to 'browser HTML'\n  * packaging a browser as a xulrunner package, or a standalone exectuable (not yet implemented)\n  * running unit tests (not yet implemented)\n  * generating static documentation for all current APIs (not yet implemented)\n\nTo get started, you should clone this repository (or download a versioned snapshot) and run:\n\n    (win32) C:\\xxx\\chromeless\u003e chromeless\n    (osx)   $ ./chromeless\n\nBy default, the HTML files in `examples/first_browser` will be executed, and you'll see a very\nsimple browser based on them.  You may also specify an alternate browser HTML on the command line:\n\n    (win32) C:\\xxx\\chromeless\u003e chromeless examples\\webgl\n    (osx)   $ ./chromeless examples/webgl\n\nFrom here, you can inspect the implementation of any of these samples, copy, modify and explore.\n\nFor deployment or to share your application, you can use chromeless to generate a standalone\napplication folder, that anyone on a supported platform can run.  Output will be placed\nin the build/ directory:\n\n    (win32) C:\\xxx\\chromeless\u003e chromeless appify examples\\webgl\n    (osx)   $ ./chromeless appify examples/webgl\n\nFinally, it's possible to generate a \"XULRunner application\", which is a folder that is much\nsmaller than a standalone application, but can be run under (a specific version of) xulrunner.\nAgain, the output will be placed in the build/ directory:\n\n    (win32) C:\\xxx\\chromeless\u003e chromeless  package examples\\webgl\n    (osx)   $ ./chromeless package examples/webgl \n\n## Documentation and Additional Information\n\nTo generate a local API documentation, use: \n\n    (win32) C:\\xxx\\chromeless\u003e chromeless docs\n    (osx)   $ ./chromeless docs\n\nYou may also check the [Chromeless documentation online](http://mozilla.github.com/chromeless), plus \ninline examples can also be helpful. You can always find us on irc in `#labs` \nat `irc.mozilla.org`, or get help or discuss this project on our mailing\n list: `mozilla-labs@googlegroups.com`\n\n## Sub-projects for Tests \n\nA Tests application is provided along wth Chromeless and can execute tests for all the \napps under tests/ directory that have the test-app.js file in it: \n\n    (win32) C:\\xxx\\chromeless\u003e chromeless tests\n    (osx)   $ ./chromeless tests\n\n## Gallery \n\nAn early version of a developer's gallery is now part of this git repository using \ngit sub-modules. You may use Chromeless to launch or package these examples that \nprovided in the gallery/ directory. In order to pull the projects from the gallery/ \n, you will need to initialize and update using git submodule. Example: \n\n    (linux) git submodule init ./gallery/simple-text-editor\n    (win32) git submodule init .\\gallery\\simple-text-editor\n\n    (linux) git submodule update ./gallery/simple-text-editor\n    (win32) git submodule update .\\gallery\\simple-text-editor\n\n    (win32) C:\\xxx\\chromeless\u003e chromeless .\\gallery\\simple-text-editor\n    (osx)   $ ./chromeless ./gallery/simple-text-editor\n\n## Notes and Known Issues\n\n  * You need to pass a relative path to your application when you invoke chromeless script \n  * This version only packages your files that are under your main application directory. So if you use, for example, jquery in a sub-directory, it will not be bundled. Make sure you have all your files in the same directory. \n  * With Mac OSX, if you launch the application for tests ( not passing package option ), the keyboard output will show in the console and not in the browser screen. For Mac OSX, you may need to use the \"package\" argument and install in your machine. \n  * It works with some specific versions of XULRunner. And to help out developers, the chromeless script will fetch a XULRunner SDK. \n\n## LICENSE\n\nAll files that are part of this project are covered by the following\nlicense, except where explicitly noted.\n\n    Version: MPL 1.1/GPL 2.0/LGPL 2.1\n\n    The contents of this file are subject to the Mozilla Public License Version\n    1.1 (the \"License\"); you may not use this file except in compliance with\n    the License. You may obtain a copy of the License at\n    http://www.mozilla.org/MPL/\n\n    Software distributed under the License is distributed on an \"AS IS\" basis,\n    WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License\n    for the specific language governing rights and limitations under the\n    License.\n\n    The Original Code is chromeless.\n\n    The Initial Developer of the Original Code is the Mozilla Foundation.\n\n    Portions created by the Initial Developer are Copyright (C) 2010\n    the Initial Developer. All Rights Reserved.\n\n    Contributor(s):\n\n    Alternatively, the contents of this file may be used under the terms of\n    either the GNU General Public License Version 2 or later (the \"GPL\"), or\n    the GNU Lesser General Public License Version 2.1 or later (the \"LGPL\"),\n    in which case the provisions of the GPL or the LGPL are applicable instead\n    of those above. If you wish to allow use of your version of this file only\n    under the terms of either the GPL or the LGPL, and not to allow others to\n    use your version of this file under the terms of the MPL, indicate your\n    decision by deleting the provisions above and replace them with the notice\n    and other provisions required by the GPL or the LGPL. If you do not delete\n    the provisions above, a recipient may use your version of this file under\n    the terms of any one of the MPL, the GPL or the LGPL.\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmozilla%2Fchromeless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmozilla%2Fchromeless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmozilla%2Fchromeless/lists"}