{"id":15007161,"url":"https://github.com/rushabh-v/linux_face_unlock","last_synced_at":"2025-04-09T15:54:38.358Z","repository":{"id":55794391,"uuid":"213179129","full_name":"rushabh-v/linux_face_unlock","owner":"rushabh-v","description":"A face authentication system for Ubuntu that works while logging in and running \"sudo\" commands with a friendly CLI to operate it.","archived":false,"fork":false,"pushed_at":"2020-12-19T04:38:07.000Z","size":1627,"stargazers_count":64,"open_issues_count":7,"forks_count":14,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-23T18:11:39.570Z","etag":null,"topics":["debian","debian-packaging","face-recognition","face-unlock","facerec","linux","linux-app","linux-face-unlock","pam","pam-authentication","pam-python","python","ubuntu"],"latest_commit_sha":null,"homepage":"https://medium.com/analytics-vidhya/how-i-built-face-unlock-for-ubuntu-linux-a2b769d1fbc1","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rushabh-v.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}},"created_at":"2019-10-06T14:03:08.000Z","updated_at":"2025-02-24T04:55:55.000Z","dependencies_parsed_at":"2022-08-15T07:01:33.453Z","dependency_job_id":null,"html_url":"https://github.com/rushabh-v/linux_face_unlock","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rushabh-v%2Flinux_face_unlock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rushabh-v%2Flinux_face_unlock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rushabh-v%2Flinux_face_unlock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rushabh-v%2Flinux_face_unlock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rushabh-v","download_url":"https://codeload.github.com/rushabh-v/linux_face_unlock/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248064846,"owners_count":21041863,"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":["debian","debian-packaging","face-recognition","face-unlock","facerec","linux","linux-app","linux-face-unlock","pam","pam-authentication","pam-python","python","ubuntu"],"created_at":"2024-09-24T19:04:54.056Z","updated_at":"2025-04-09T15:54:38.325Z","avatar_url":"https://github.com/rushabh-v.png","language":"Python","readme":"\n# Facerec - Linux Face Unlock\nFacerec is a face authentication system for Ubuntu Linux that works while logging in, running \"sudo\" commands, etc. with a user-friendly CLI to operate it.\n\n\n## Installation\n\n### Using PPA\n\n#### 1. Update Sources\n```\nsudo apt update\n```\n#### 2. add PPA to your machine\n```\nsudo add-apt-repository ppa:rushabh-v/facerec\n```\n\n#### 3. Install Facerec\n```\nsudo apt install facerec\n```\n\n#### 4. Source bashrc\n```\nsource ~/.bashrc\n```\n\n### Using deb package\n\n#### 1. Download the deb package\n```\nwget https://github.com/rushabh-v/linux_face_unlock/releases/download/v1.1/facerec_1.1_all.deb\n```\n\n#### 2. Install all the dependencies\n```\nsudo apt install -y python3-pip python3-opencv python3-setuptools python-execnet cmake libatlas-base-dev build-essential\n```\n\n#### 3. Install the deb package using\n```\nsudo dpkg -i facerec_1.1_all.deb\n```\n\n#### 4. Source bashrc\n```\nsource ~/.bashrc\n```\n\nNOTE: The deb package won't receive updates automatically. The PPA method is more preferable.\n\n\n## Command Line Interface\n\n| Command | Description |\n|---------|-------------|\n| facerec new | Add a new root face |\n| facerec enable | Enable facerec |\n| facerec disable | Temporarily disable facerec |\n| facerec remove | Completely remove the facerec |\n| facerec --version | Display installed version of facerec |\n| facerec --help | Get the CLI info |\n\nTry using the tab compeletions. It is one of the trivial features I am extra proud of :joy:\n\n\n## Contributions Welcome\n* Bug reports, Feature requests and PRs will be highly appreciated.\n* Dockerfile for the testing environment can be found here. (Will soon upload the image to docker hub)\n* Currently, facerec is only supported on Ubuntu. Adding support for other distros is on the list of major future plans.\n\n## Troubleshoot\n\n* If you don't have root access. Go to recovery mode as root and run,\n\n```\nfacerec remove\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frushabh-v%2Flinux_face_unlock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frushabh-v%2Flinux_face_unlock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frushabh-v%2Flinux_face_unlock/lists"}