저장해둔 WiFi를 QR로 건네는 도구입니다. 계정도, 서버도 없습니다.
한 줄 요약 — 폰·노트북에 이미 있는 기능은 지금 연결된 그 하나만 보낼 수 있습니다. wisp는 사무실에서 우리집 WiFi를, 지금 그 자리에 없는 네트워크를 건넬 수 있습니다.
담는 방법은 넷입니다. 상황에 맞는 것을 고르세요.
가장 확실합니다. + 를 눌러 이름(SSID)·비밀번호를 넣고, 알아보기 쉬운 라벨(예: 우리집, 사무실)을 붙입니다.
공유기 스티커를 카메라로 찍으면 SSID와 비밀번호를 읽어 채워줍니다. 글자 인식은 기기 안에서 돌아갑니다 — 사진이 어디로도 올라가지 않습니다.
처음 한 번은 인식 엔진(약 5.7MB)을 내려받습니다. 그 뒤로는 인터넷 없이도 됩니다.
상대가 띄운 WiFi QR을 스캔하면 그대로 담깁니다. 안드로이드·아이폰 상관없이 같은 방식입니다.
PC에 저장된 WiFi를 텍스트로 뽑아 설정 → 가져오기 에 붙여넣으면,
목록을 보여주고 담을 것만 고르게 합니다. 뽑는 스크립트는 저장소의 scripts/ 에 있습니다.
⚠️ 폰에 저장된 WiFi는 자동으로 가져올 수 없습니다. 웹에는 그런 API가 없고, 네이티브 앱이어도 Android 10+ 는 저장된 비밀번호를 앱에 주지 않습니다(iOS는 통로 자체가 없습니다). 꺼낼 수 있는 곳은 컴퓨터뿐이라 그 경로를 열어둔 것입니다.
카드가 여섯 장을 넘으면 목록 위에 찾기 칸이 나타납니다. 이름·네트워크 이름·쪽지 내용으로 걸러집니다.
카드를 누르면 바로 QR이 뜹니다. 상대가 카메라로 비추면 비밀번호를 말하거나 적지 않고 연결됩니다. QR을 띄운 동안에는 화면이 꺼지지 않습니다 — 상대가 스캔하는 중에 잠기면 곤란하니까요.
공유 카드를 만들면 1080×1620 이미지가 나옵니다. 매장·사무실 입구에 붙여두면 손님이 알아서 스캔합니다. 사장님 폰을 매번 꺼낼 필요가 없어집니다.
바로 뽑으실 거면 인쇄하기를 누르세요. 저장했다가 다시 여는 단계 없이 인쇄 창이 바로 뜹니다. 나오는 종이는 공유 카드와 같은 그림입니다.
붙이는 자리와 크기는 매장·카페 WiFi 안내판 만들기에 정리해뒀습니다.
지갑에는 쪽지도 담을 수 있습니다. 계좌번호·주소·긴 링크처럼 불러주기 번거로운 텍스트를 QR로 건네는 자리입니다.
+ 추가 를 누르면 WiFi 와 쪽지 중에 고르게 됩니다.
쪽지를 고르고 내용을 붙여넣으면 끝입니다.
칸 아래 막대가 남은 양을 보여줍니다. QR에 담을 수 있는 양이 정해져 있어서, 넘으면 코드를 만들 수 없기 때문입니다. 초록에서 주황·빨강으로 바뀌면 줄여주세요.
WiFi와 똑같습니다. 카드를 누르면 QR이 뜨고, 상대가 카메라로 비추면 그 텍스트가 그대로 나옵니다. 대부분의 폰은 거기서 복사 버튼을 띄워줍니다.
상대가 띄운 쪽지 QR을 wisp의 QR 스캔으로 찍으면 내 지갑에 담깁니다. WiFi QR이 아니어도 읽을 수 있는 글자면 쪽지로 받습니다.
담을 수 있는 양 — 한글 약 500자, 영문 약 1,500자입니다. 인쇄해서 붙여도 잘 읽히도록 여유를 두고 잡은 값입니다.
⚠️ QR에는 적은 내용이 그대로 들어 있습니다. 화면을 캡처해 단톡방에 올리면 그 내용을 공개한 것과 같습니다. 자세한 것은 QR 원리를 보세요.
QR을 쓸 수 없을 때가 있습니다. 메신저로 보내야 하거나, 상대가 멀리 있거나, 화면을 마주 볼 수 없는 상황입니다. 그럴 때는 링크 복사를 쓰세요.
카드 정보가 주소 안에 담긴 링크가 만들어집니다. 받은 사람이 그 링크를 누르면 담기 화면이 바로 열립니다.
서버를 거치지 않습니다. 데이터는 주소의 # 뒤에 실리는데,
브라우저는 그 부분을 서버로 보내지 않습니다.
우리 서버에도, 중간 어디에도 기록이 남지 않습니다.
⚠️ 다만 링크 자체가 비밀번호입니다. QR은 화면에 잠깐 떴다 사라지지만, 링크는 대화방에 그대로 남습니다. 받을 사람에게만 보내고, 단체방에는 올리지 마세요.
잠금을 켜면 저장된 비밀번호가 암호화되어 보관됩니다(PBKDF2 210,000회 + AES-GCM). 키는 메모리에만 있고 저장되지 않습니다.
⚠️ PIN을 잊으면 복구할 방법이 없습니다. 서버가 없으니 "비밀번호 찾기"를 보낼 곳도 없습니다. 잠금을 켜기 전에 백업 파일을 먼저 내려받아 두세요.
설정 → 내보내기 로 JSON 파일을 받아 두세요. 기기를 바꾸거나 브라우저 데이터를 지우면 저장한 것이 함께 사라집니다 — 서버에 사본이 없기 때문입니다.
가져올 때도 목록을 먼저 보여주고 고르게 합니다. 통째로 덮어쓰지 않습니다.
설치하면 인터넷 없이도 열립니다. 앱처럼 아이콘이 생기고 주소창이 사라집니다.
| 기기 | 방법 |
|---|---|
| 아이폰 · 아이패드 | 사파리에서 공유 → 홈 화면에 추가 |
| 안드로이드 | 크롬 메뉴 → 홈 화면에 추가 (설치 배너가 뜨면 그걸 눌러도 됩니다) |
| 데스크톱 | 주소창 오른쪽 설치 아이콘 |
⚠️ 설치하지 않고 브라우저 탭으로만 쓰면, 브라우저 정리 기능이 저장소를 비울 때 데이터가 사라질 수 있습니다. 첫 실행에서 설치를 권하는 이유입니다.