{"id":22111080,"url":"https://github.com/4ch1m/littlecontainerpeople","last_synced_at":"2026-02-15T08:34:04.835Z","repository":{"id":79699402,"uuid":"404844652","full_name":"4ch1m/LittleContainerPeople","owner":"4ch1m","description":"Activision's Little Computer People inside a (Docker) container.","archived":false,"fork":false,"pushed_at":"2025-01-11T18:32:21.000Z","size":484,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-12T04:32:15.037Z","etag":null,"topics":["c64","c64-game","commodore","containerization","docker"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/4ch1m.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-09T19:23:06.000Z","updated_at":"2025-01-11T18:32:24.000Z","dependencies_parsed_at":"2025-01-29T10:38:55.025Z","dependency_job_id":null,"html_url":"https://github.com/4ch1m/LittleContainerPeople","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/4ch1m/LittleContainerPeople","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4ch1m%2FLittleContainerPeople","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4ch1m%2FLittleContainerPeople/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4ch1m%2FLittleContainerPeople/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4ch1m%2FLittleContainerPeople/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/4ch1m","download_url":"https://codeload.github.com/4ch1m/LittleContainerPeople/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4ch1m%2FLittleContainerPeople/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29473718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T06:58:05.414Z","status":"ssl_error","status_checked_at":"2026-02-15T06:58:05.085Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["c64","c64-game","commodore","containerization","docker"],"created_at":"2024-12-01T10:33:08.281Z","updated_at":"2026-02-15T08:34:04.819Z","avatar_url":"https://github.com/4ch1m.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Little Container People\n\u003e Activision's [Little Computer People](https://en.wikipedia.org/wiki/Little_Computer_People) inside a ([Docker](https://www.docker.com/)) container. :man_dancing: :dog2: :house:\n\n![LCP](/lcp.png?raw=true)\n\n## Content\n\n* [Concept](#concept)\n* [Ingredients](#ingredients)\n* [Requirements](#requirements)\n* [Instructions](#instructions)\n* [Customization](#customization)\n  * [Game binary, Access port, Emulator options](#game-binary-access-port-emulator-options)\n  * [CareService container](#careservice-container)\n* [Links](#links)\n* [License](#license)\n\n### Concept\n\n```\n               ┌────────────────────────────────────────────────────────────┐\n               │ LCP Container                                              │\n               │                                                            │\n┌─────────┐    │   ┌──────────────┐    ┌────────────┐    ┌──────────────┐   │\n│ Web     │    │   │ (HTML-based) │    │            │    │              │   │\n│ Browser │    │   │ VNC Viewer   │    │ VNC Server │    │ C64 Emulator │   │\n│       ◄─┼────┼───┼─►     ▲    ◄─┼────┼─►        ◄─┼────┼─►     ▲      │   │\n└─────────┘    │   └───────┼──────┘    └────────────┘    └───────┼──────┘   │\n               │           │                                     │          │\n               ├───────────┼─────────────────────────────────────┼──────────┤\n               │           │                [ LCP game binary ] ─┘          │\n               └───────────┼────────────────────────────────────────────────┘\n                           │\n---------------------------│----------------------------------------------------------------\n(optional)                 │\n                 ┌─────────┼─────────────────────────────────────────────┐\n                 │ LCP CareService Container                             │\n                 │         │                                             │\n                 │   ┌─────┼────────────────────┐    ┌───────────────┐   │\n                 │   |                          |    |               |   │\n                 │   | Automated Browser Action |    | Cron Schedule |   │\n                 │   |                        ◄─┼────┼─              |   │\n                 │   └──────────────────────────┘    └───────────────┘   │\n                 │                                                       │\n                 └───────────────────────────────────────────────────────┘\n```\n\n### Ingredients\n\n* Web Browser: Any HTML5 capable web browser.\n* Container OS: [Debian](https://hub.docker.com/_/debian)\n* VNC Viewer: [noVNC](https://novnc.com/)\n* VNC Server: [x11vnc](https://github.com/LibVNC/x11vnc)\n* C64 Emulator: [VICE](https://vice-emu.sourceforge.io/)\n* Browser Automation: [Puppeteer](https://github.com/puppeteer/puppeteer)\n* Cron Scheduler: Debian Cron-Daemon\n\n### Requirements\n\n* [Docker](https://www.docker.com/) (and [docker-compose](https://docs.docker.com/compose/)) installed on your system.\n* The [Little Computer People](https://en.wikipedia.org/wiki/Little_Computer_People) game binary (in disk or tape format).\n* An itch for nostalgic entertainment. :joystick: \n\n### Instructions\n\n* Clone this repository:  \n  `git clone https://github.com/4ch1m/LittleContainerPeople.git`\n\n\n* **IMPORTANT:**  \n  Place your D64-binary of LCP into the cloned directory and name it `lcp.d64`.  \n  (The tape version can also be used; see \"[Customization](#customization)\" below.)\n\n\n* Execute:  \n  `docker-compose up`  \n  (This will build and start the container(s).)\n\n\n* Open a web-browser and navigate to `http://localhost:8080`.\n\n\n* You should see the output of VICE in your browser.  \n  (Note: It may take a few seconds until VICE finished loading the disk/tape; so be patient.)\n\n\n* Enjoy! :nerd_face:\n\n### Customization\n\nSimply create an `.env` file right next to the [docker-compose.yml](docker-compose.yml) file and set the values as needed.\n\n##### \"lcp\" container\n\n* `LCP_BIN`: The file that gets auto-loaded by VICE upon container start (default: \"lcp.d64\").\n* `LCP_PORT`: The port under which the web interface can be reached (default: \"8080\").\n* `LCP_VICE_OPTS`: Additional [options/settings](https://vice-emu.sourceforge.io/vice_6.html) for the VICE emulator (default: \"-VICIIfilter 0\").\n\ne.g.\n\n```\nLCP_BIN=lcp.t64\nLCP_PORT=8181\nLCP_VICE_OPTS=-speed 500\n```\n\n#### \"lcp_careservice\" container\n\nThis is an optional sidecar container that can help to keep your LittleContainerPeople alive without having to actively interact with it all the time. \n\nEvery fifteen minutes the service will send these three keyboard commands to the running LCP instance; covering the essential physical needs of your LCP:\n* \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eF\u003c/kbd\u003e (:hamburger: send food)\n* \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eW\u003c/kbd\u003e (:cup_with_straw: fill watertank)\n* \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eD\u003c/kbd\u003e (:canned_food: send dogfood)\n\n(Prevents the LCP of getting sick. :nauseated_face:)\n\nAdditionally, a random activity from this list will be sent:\n* \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eA\u003c/kbd\u003e (:alarm_clock: alarm clock)\n* \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eC\u003c/kbd\u003e (:phone: make phone call)\n* \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eP\u003c/kbd\u003e (:wave: patting)\n* \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eR\u003c/kbd\u003e (:cd: send a record)\n* \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eB\u003c/kbd\u003e (:closed_book: send a book)\n\n(Should improve the overall mood of your LCP.)\n\nIf needed, you can configure the target URL which the careservice connects to:\n\n```\nLCP_CARESERVICE_TARGETURL=http://yourhost:8181\n```\n(Should only be relevant if you host the `lcp` and `lcp_careservice` containers on different machines.)\n\nYou can disable this feature completely by commenting out or removing the according lines in [docker-compose.yml](docker-compose.yml).\n\n### Links\n\n* Helpful information about the game: [C64 Wiki](https://www.c64-wiki.com/wiki/Little_Computer_People)\n* LCP Tools from Snowdog: [CSDb](https://csdb.dk/release/?id=56264\u0026show=notes)\n* YouTube videos:  \n  - [C64-Longplay](https://www.youtube.com/watch?v=LFcg8I21cng) | DerSchmu\n  - [The Sims wouldn't exist without This](https://www.youtube.com/watch?v=rYz_leh9J3E) | Nostalgia Nerd\n  - [The secret way every Little Computer People floppy disk was unique](https://www.youtube.com/watch?v=wZpqABBbd_I) | Retro Recipes\n  - [What was Artificial Intelligence like in 1985? Ask Little Computer People!](https://www.youtube.com/watch?v=yqVlydAEKmg) | Retro Recipes\n\n### License\n\nsee [LICENSE](LICENSE) file\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4ch1m%2Flittlecontainerpeople","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F4ch1m%2Flittlecontainerpeople","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4ch1m%2Flittlecontainerpeople/lists"}