Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

RaspiPass 3DS: Difference between revisions

From GameBrew
No edit summary
m (Text replacement - "Category:PC utilities for 3DS homebrew" to "")
 
(22 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox-3DS-Homebrews
{{Infobox 3DS Homebrews
| title = RaspiPass
|title=RaspiPass
| image = https://dlhb.gamebrew.org/3dshomebrew/RaspiPass.jpeg|250px
|image=Raspipass4.png
| type = Utilities
|description=RaspiPass - Homepass software for the Raspberry Pi 3.
| version=v0.7.3
|author=Pinchie
| lastupdated = 2017/04/30
|lastupdated=2017/04/30
| licence = Mixed
|type=PC Utilities
| author = Pinchie
|version=0.7.4
| website = https://github.com/Pinchie/RaspiPass
|license=Mixed
| download = https://dlhb.gamebrew.org/3dshomebrew/RaspiPass-3DS.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/raspipass.7z?k33p0fil35
| source = https://github.com/Pinchie/RaspiPass
|website=https://github.com/Pinchie/RaspiPass
|source=https://github.com/Pinchie/RaspiPass
}}
}}
<youtube>eudgVP6aMW0</youtube>
{{Obsolete}}


'''As of the beginning of April 2018, Nintendo has discontinued the Streetpass Relay system - which has effectively killed HomePass in its' current state. If any further developments are made to the HomePass system (e.g. some sort of Homebrew version), then this sheet will be updated to reflect those changes. But for now it is a sad farewell to one of the best updates Nintendo released for the 3DS. It's been a fun 5 years - so long and thanks for all the passes!'''
RaspiPass is a means of accessing StreetPass Relay points from your home, allowing you to send and receive StreetPass hits all over the world. It uses a method commonly known as *Homepass* to emulate an existing StreetPass Relay access point, and exchange hits with Nintendo's servers.


==RaspiPass==
Previous versions of RaspiPass existed for the Raspberry Pi 1 and 2 but relied on an external USB wireless network adapter, and these were only distributed to friends as complete units with compatible wifi dongles. With the release of the Raspberry Pi 3 and it's on-board wifi adapter, RaspiPass as it's known today was created. It was the first of its kind written specifically for the Raspberry Pi 3, intended to be a single unit without any need of peripherals.


Current installations should be able to be made functional again by running the following over SSH:
'''Note:''' As of the beginning of April 2018, Nintendo has discontinued the Streetpass Relay system and RaspiPass is no longer usable.
<pre>
sudo iptables -A INPUT -s 52.43.174.40 -j ACCEPT
sudo iptables -A INPUT -s 192.195.204.216 -j ACCEPT
sudo iptables -A INPUT -s 52.10.249.207 -j ACCEPT
sudo iptables -A OUTPUT -d 52.43.174.40 -j ACCEPT
sudo iptables -A OUTPUT -d 192.195.204.216 -j ACCEPT
sudo iptables -A OUTPUT -d 52.10.249.207 -j ACCEPT
sudo iptables -A FORWARD -d 52.43.174.40 -j ACCEPT
sudo iptables -A FORWARD -d 192.195.204.216 -j ACCEPT
sudo iptables -A FORWARD -d 52.10.249.207 -j ACCEPT
sudo iptables -A FORWARD -s 52.43.174.40 -j ACCEPT
sudo iptables -A FORWARD -s 192.195.204.216 -j ACCEPT
sudo iptables -A FORWARD -s 52.10.249.207 -j ACCEPT
sudo iptables-save > /raspi_secure/firewall.rules
</pre>


For those who prefer re-imaging (probably most) I've got an image of 0.74 with the updated firewall rules zipping for uploading now. There's also a beta release in the git working local tree of the image. You can give that a look-see by SSH'ing in and running.
==Features==
<code>
* Simple setup using only a Raspberry Pi 3 and its on-board hardware.
cd /git
* Activates automatically based on user-configurable random timings.
git checkout working
* Configuration via web front-end.
sudo ./scripts/copy_to_sysdirs.sh -a</code>
* Firewall configuration to only allow traffic necessary for StreetPass Relay.


The main changes worth noting in the beta are:
==Installation==
===Before installing===
* Download the archive and run Win32 Disk Imager (Windows) or ApplePi-Baker (Mac).
* If running Windows, extract the .img file from the zipped image file.
* Insert a Micro-SD card 2Gb or larger.


* A better back-end for the Web GUI (I learned how!)
===Write Image - Windows===
* Locale changing from the Web GUI (I learned how!)
* Open Win32 Disk Imager, click the "Open" icon and select the .img file extracted earlier.
* Select your Micro-SD's drive letter from the drop-down.
* Click the "Write" button to write the image to the selected drive.
* Once complete, close Win32 Disk Imager and safely eject your Micro-SD.


(previous post continues below....)
===Write Image - Mac===
* Open ApplePi-Baker - you will need to enter your admin password.
* Select your Micro-SD in the left of the window.
* Click "Prep for NOOBS" to format the card.
* Click the "..." button in the Restore section of the window, and select the RaspiPass .zip file downloaded earlier.
* Click the "Restore" button to write the image to the selected drive.
* Once complete, close ApplePi-Baker and safely eject your Micro-SD.


=== New version - 0.7.4 12/12/2016 ===
'''Update from developer 30/04/2017:'''
Released 0.7.4 in the hope it will solve some of the errors people have been reporting. I recommend you reimage rather than upgrade, due to some filesystem changes altering/overriding log locations.


==== Changes this version ====
Installations should be able to be made functional again by running the following over SSH (if you have previous verison installed, it is advised to reimage rather than upgrade, due to some filesystem changes altering/overriding log locations).
There are a few changes this version, including some script standardisation and directory changes.


==== Log & live config location changes ====
sudo iptables -A INPUT -s 52.43.174.40 -j ACCEPT
* Moved almost every dynamic RaspiPass file (eg logs, dynamic config) to /var/raspipass
sudo iptables -A INPUT -s 192.195.204.216 -j ACCEPT
* Configured two tmpfs drives mounted on /var/raspipass and /var/log/apache2 in order to reduce SD use
sudo iptables -A INPUT -s 52.10.249.207 -j ACCEPT
* Added configuration in copy_to_sysdirs.sh to create these mount points in fstab if they do not exist (reboot required after)
sudo iptables -A OUTPUT -d 52.43.174.40 -j ACCEPT
sudo iptables -A OUTPUT -d 192.195.204.216 -j ACCEPT
sudo iptables -A OUTPUT -d 52.10.249.207 -j ACCEPT
sudo iptables -A FORWARD -d 52.43.174.40 -j ACCEPT
sudo iptables -A FORWARD -d 192.195.204.216 -j ACCEPT
sudo iptables -A FORWARD -d 52.10.249.207 -j ACCEPT
sudo iptables -A FORWARD -s 52.43.174.40 -j ACCEPT
sudo iptables -A FORWARD -s 192.195.204.216 -j ACCEPT
sudo iptables -A FORWARD -s 52.10.249.207 -j ACCEPT
sudo iptables-save > /raspi_secure/firewall.rules


==== Script changes ====
There is also beta release in the git working local tree of the image. You can give that a look-see by SSH'ing in and running.  
* Standardised scripts with parameters - all scripts now have an -h parameter
* Improved update script
* Altered copy_to_sysdirs.sh to reference a csv file /git/scripts/filepermissions to use as a source when copying & setting permissions
* Added more logs to /raspi_secure/clear_logs.sh
* Cleaned up output of clear_logs.sh and set_defaults.sh
* Removed copy_to_gitdir.sh - this was only required when I wasn't using Git properly :)


==== Other changes ====
cd /git
* Removed lots of commented out lines of code that were used during initial debugging
git checkout working
* Set up daily downloading of latest version file from GitHub raw servers (for update checking)
sudo ./scripts/copy_to_sysdirs.sh -a
* Added notification of required reboot to Web GUI (triggered by presence of /var/raspipass/reboot - message is contents of first line
* Added daily download task (at 00:00:00) of latest master 'version' file from GitHub server to check for latest version file
* Permitted access to GitHub raw server to allow above download


=== Quick Links ===
==User guide==
For people diving in just to update, or who know what they're doing, the key links you may need are below.
===Start RaspiPass===
I've finally started making some proper docs on the GitHub page's wiki - this documentation will likely be more detailed than the (still verbose) documentation here.
Insert the Micro-SD card into your powered-down Raspberry Pi 3 (with ethernet connected) and turn on.


Description Link
Allow the device to boot up (the first boot may take a little while as it may need to perform some initial storage fiddling).
StreetPass Relay Info [[http://en-americas-support.nintendo.com/app/answers/detail/a_id/709/~/streetpass-relay-overview|via Nintendo NA]]
Image & Imaging Software [[https://www.dropbox.com/sh/74oi73urfizi27o/AACZIJIEQatBPK9pg_p9Iojka/Disk%20image?dl=0|via Dropbox]]


==What is RaspiPass?==
Open http://raspipass/ to access the Web GUI and adjust settings as desired.
RaspiPass is a means of accessing StreetPass Relay points from your home, allowing you to send and receive StreetPass hits all over the world. It uses a method commonly known as *Homepass* to emulate an existing StreetPass Relay access point, and exchange hits with Nintendo's servers.


Previous versions of RaspiPass existed for the Raspberry Pi 1 and 2 but relied on an external USB wireless network adapter, and these were only distributed to friends as complete units with compatible wifi dongles. With the release of the Raspberry Pi 3 and it's on-board wifi adapter, RaspiPass as it's known today was created. It was the first of its kind written specifically for the Raspberry Pi 3, intended to be a single unit without any need of peripherals.
From here the device should run automatically. You can force the script to start, or shut down the device by using the buttons under the "Admin Tasks" tab in the Web GUI.


==Features==
===Useful links===
* Simple setup using only a Raspberry Pi 3 and its onboard hardware
* StreetPass Relay Info via [http://en-americas-support.nintendo.com/app/answers/detail/a_id/709/~/streetpass-relay-overview Nintendo NA].
* Activates automatically based on user-configurable random timings
* Image & Imaging Software via [https://www.dropbox.com/sh/74oi73urfizi27o/AACZIJIEQatBPK9pg_p9Iojka/Disk%20image?dl=0 Dropbox].
* Configuration via web front-end
* Wiki (Guide/FAQs) via [https://github.com/Pinchie/RaspiPass/wiki GitHub].
* Firewall configuration to only allow traffic necessary for StreetPass Relay and device operation/configuration
* HomePass [http://web.archive.org/web/20190912145424/http://homepass.info Spreadsheet] ([https://docs.google.com/spreadsheets/d/1su5u-vPrQwkTixR6YnOTWSi_Ls9lV-_XNJHaWIJspv4/edit#gid=0 backup]).


==Installation==
===FAQ===
===Download & Prepare===
'''Q. What are the login details?'''
# Download the latest zipped image from the Dropbox directory
# Download and run Win32 Disk Imager (Windows) or ApplePi-Baker (Mac)
# If running Windows, extract the .img file from the zipped image file
# Insert a Micro-SD card 2Gb or larger


=== Write Image - Windows ===
User: raspi
# Open Win32 Disk Imager
Password: pinchie
# Click the "Open" icon and select the .img file extracted earlier
# Select your Micro-SD's drive letter from the drop-down
# Click the "Write" button to write the image to the selected drive
# Once complete, close Win32 Disk Imager and safely eject your Micro-SD


=== Write Image - Mac ===
'''Q.Does this work on a Raspberry Pi 2?'''
# Open ApplePi-Baker - you will need to enter your admin password
# Select your Micro-SD in the left of the window
# Click "Prep for NOOBS" to format the card
# Click the "..." button in the Restore section of the window, and select the RaspiPass .zip file downloaded earlier
# Click the "Restore" button to write the image to the selected drive
# Once complete, close ApplePi-Baker and safely eject your Micro-SD


=== Start RaspiPass ===
Not out-of-the-box. The software is set up to use the Raspberry Pi 3's on-board wireless chip, while the Pi 2 has no on-board wifi. If you can find a USB wifi adapter that will let you create an AP and change the MAC address, you may be able to use the image to get you most of the way, and you'll just have to set up your wifi adapter to work on wlan0. Results will vary from adapter to adapter, but others have succeeded using this software, a Pi2, and the right wireless adapter.
* Insert the Micro-SD card into your powered-down Raspberry Pi 3 (with ethernet connected) and turn on
* Allow the device to boot up (the first boot may take a little while as it may need to perform some initial storage fiddling)
* Open http://raspipass/ to access the Web GUI and adjust settings as desired
* From here the device should run automatically. You can force the script to start, or shut down the device by using the buttons under the "Admin Tasks" tab in the Web GUI.


==Operation==
'''Q. How secure is the wireless network this creates?'''


From here the device should run automatically. You can force the script to start, or shut down the device by using the buttons under the "Admin Tasks" tab in the Web GUI.
Hopefully, bloody secure.


==HomePass Spreadsheet==
The iptables configuration is set to allow only traffic necessary for your 3DS to jump onto the network, get an address, and talk specifically to the Nintendo StreetPass Relay servers. I do invite you to jump onto the network with another device and do some penetration testing - I'm always anxious to try and close any loopholes I may have left open. So far in my testing I haven't found any major security issues.
http://web.archive.org/web/20190912145424/http://homepass.info/


==FAQS==
'''Q. Why can't I get your image onto a 2Gb card?'''


=== What are the login details? ===
While I've been through a couple of "2Gb" cards trying to find the smallest. After a few attempts and suggestions I'm currently using a Kingston 2Gb with a total size of 1,954,545,664 bytes.
User: raspi
Password: pinchie


=== Does this work on a Raspberry Pi 2? ===
What I've learned is that cards of the same labelled size are not actually the same, and can vary from brand to brand. I aim to keep the image as small as possible, but if you find a "2Gb" card that's smaller than the image requires, you may have to use a 4Gb. Alternatively, I'm very willing to trade our 2Gb cards - my larger one for your smaller one - in order to make a more compatible image.
Not out-of-the-box. The software is set up to use the Raspberry Pi 3's on-board wireless chip, while the Pi 2 has no on-board wifi. If you can find a USB wifi adapter that will let you create an AP and change the MAC address, you may be able to use the image to get you most of the way, and you'll just have to set up your wifi adapter to work on wlan0. Results will vary from adapter to adapter, but others have succeeded using this software, a Pi2, and the right wireless adapter.
 
'''Q. Can I install manually, or do I have to use the disk image?'''


=== How secure is the wireless network this creates? ===
Well there's nothing stopping you installing manually.  
Hopefully, bloody secure.


The iptables configuration is set to allow only traffic necessary for your 3DS to jump onto the network, get an address, and talk specifically to the Nintendo StreetPass Relay servers. I do invite you to jump onto the network with another device and do some penetration testing - I'm always anxious to try and close any loopholes I may have left open. So far in my testing I haven't found any major security issues.
There is a deprecated guide [https://www.dropbox.com/sh/74oi73urfizi27o/AAB2QMEm591y8s12ZeIr38yga/Manual%20installation%20guide%20%28deprecated%29?dl=0 here], but be sure to download the most recent firewall configuration from the GitHub repo, or you won't get any StreetPass hits.


=== Why can't I get your image onto a 2Gb card? ===
'''Q. I have a router/laptop/other device I can create an access point with...can't I just use that?'''
While I've been through a couple of "2Gb" cards trying to find the smallest. After a few attempts and suggestions I'm currently using a Kingston 2Gb with a total size of 1,954,545,664 bytes.


What I've learned is that cards of the same labelled size are not actually the same, and can vary from brand to brand. I aim to keep the image as small as possible, but if you find a "2Gb" card that's smaller than the image requires, you may have to use a 4Gb. Alternatively, I'm very willing to trade our 2Gb cards - my larger one for your smaller one - in order to make a more compatible image.
Absolutely. As long as you can change the MAC address and set the SSID to the correct name you can do this yourself.  


=== Can I install manually, or do I have to use the disk image? ===
See the [http://homepass.info Homepass Site] for the info you'll need.
Well there's nothing stopping you installing manually. There is a deprecated guide here, but be sure to download the most recent firewall configuration from the GitHub repo, or you won't get any StreetPass hits.


=== I have a router/laptop/other device I can create an access point with... can't I just use that? ===
'''Q. Can I use RaspiPass with RetroPie/XBMC/other Raspberry Pi software?'''
Absolutely. As long as you can change the MAC address and set the SSID to the correct name you can do this yourself. See the Homepass Site for the info you'll need.


=== Can I use RaspiPass with RetroPie/XBMC/other Raspberry Pi software? ===
Yes and no.
Yes and no.


Line 159: Line 128:
The strict firewall setting can also be a hindrance, but if you're willing to sacrifice the security of the open network for co-functionality with other Pi software then that's up to you - I just try to make it as secure as possible at the time of distribution. Any decisions you make from there are up to you. :)
The strict firewall setting can also be a hindrance, but if you're willing to sacrifice the security of the open network for co-functionality with other Pi software then that's up to you - I just try to make it as secure as possible at the time of distribution. Any decisions you make from there are up to you. :)


==Submitting bugs/changes/requests==
==Screenshots==
While this is basically a project I tend to set-and-forget (by design), I am very open to any suggestions for improvements, and even moreso if you find any issues I've overlooked. If you have any problems, questions, bugs or suggestions, either post in this topic or hop over to the GitHub page here.
https://dlhb.gamebrew.org/3dshomebrews/raspipass3.png
 
==Media==
[https://www.youtube.com/watch?v=eudgVP6aMW0 How to Get Free StreetPass With Raspipass | Raspberry Pi | From Start To Finish] (by HighTeckMan).
 
==Changelog==
'''beta'''
* A better back-end for the Web GUI.
* Locale changing from the Web GUI.
 
'''0.7.4 2016/12/12'''
 
Log & live config location changes:
* Moved almost every dynamic RaspiPass file (eg logs, dynamic config) to /var/raspipass.
* Configured two tmpfs drives mounted on /var/raspipass and /var/log/apache2 in order to reduce SD use.
* Added configuration in copy_to_sysdirs.sh to create these mount points in fstab if they do not exist (reboot required after).
 
Script changes:
* Standardised scripts with parameters - all scripts now have an -h parameter.
* Improved update script.
* Altered copy_to_sysdirs.sh to reference a csv file /git/scripts/filepermissions to use as a source when copying & setting permissions.
* Added more logs to /raspi_secure/clear_logs.sh.
* Cleaned up output of clear_logs.sh and set_defaults.sh.
* Removed copy_to_gitdir.sh - this was only required when Git wasn't used properly.
 
Other changes:
* Removed lots of commented out lines of code that were used during initial debugging.
* Set up daily downloading of latest version file from GitHub raw servers (for update checking).
* Added notification of required reboot to Web GUI (triggered by presence of /var/raspipass/reboot - message is contents of first line.
* Added daily download task (at 00:00:00) of latest master 'version' file from GitHub server to check for latest version file.
* Permitted access to GitHub raw server to allow above download.


If you're a software or web developer and want to take a look through to see what you can add, please feel free. I apologise in advance for your brain after seeing my code.. I rarely code anything, and my web design skills are basic programming skills with a complete lack of aesthetic knowledge thrown in. Please feel free to play around and make improvements. If you want to collaborate, I'd be delighted.
==External links==
* GitHub - https://github.com/Pinchie/RaspiPass
* Reddit - https://www.reddit.com/r/3DS/comments/5anc74/raspipass_homepass_software_for_raspberry_pi_3

Latest revision as of 04:28, 6 Mayıs 2024

RaspiPass
Raspipass4.png
General
AuthorPinchie
TypePC Utilities
Version0.7.4
LicenseMixed
Last Updated2017/04/30
Links
Download
Website
Source

RaspiPass is a means of accessing StreetPass Relay points from your home, allowing you to send and receive StreetPass hits all over the world. It uses a method commonly known as *Homepass* to emulate an existing StreetPass Relay access point, and exchange hits with Nintendo's servers.

Previous versions of RaspiPass existed for the Raspberry Pi 1 and 2 but relied on an external USB wireless network adapter, and these were only distributed to friends as complete units with compatible wifi dongles. With the release of the Raspberry Pi 3 and it's on-board wifi adapter, RaspiPass as it's known today was created. It was the first of its kind written specifically for the Raspberry Pi 3, intended to be a single unit without any need of peripherals.

Note: As of the beginning of April 2018, Nintendo has discontinued the Streetpass Relay system and RaspiPass is no longer usable.

Features

  • Simple setup using only a Raspberry Pi 3 and its on-board hardware.
  • Activates automatically based on user-configurable random timings.
  • Configuration via web front-end.
  • Firewall configuration to only allow traffic necessary for StreetPass Relay.

Installation

Before installing

  • Download the archive and run Win32 Disk Imager (Windows) or ApplePi-Baker (Mac).
  • If running Windows, extract the .img file from the zipped image file.
  • Insert a Micro-SD card 2Gb or larger.

Write Image - Windows

  • Open Win32 Disk Imager, click the "Open" icon and select the .img file extracted earlier.
  • Select your Micro-SD's drive letter from the drop-down.
  • Click the "Write" button to write the image to the selected drive.
  • Once complete, close Win32 Disk Imager and safely eject your Micro-SD.

Write Image - Mac

  • Open ApplePi-Baker - you will need to enter your admin password.
  • Select your Micro-SD in the left of the window.
  • Click "Prep for NOOBS" to format the card.
  • Click the "..." button in the Restore section of the window, and select the RaspiPass .zip file downloaded earlier.
  • Click the "Restore" button to write the image to the selected drive.
  • Once complete, close ApplePi-Baker and safely eject your Micro-SD.

Update from developer 30/04/2017:

Installations should be able to be made functional again by running the following over SSH (if you have previous verison installed, it is advised to reimage rather than upgrade, due to some filesystem changes altering/overriding log locations).

sudo iptables -A INPUT -s 52.43.174.40 -j ACCEPT
sudo iptables -A INPUT -s 192.195.204.216 -j ACCEPT
sudo iptables -A INPUT -s 52.10.249.207 -j ACCEPT
sudo iptables -A OUTPUT -d 52.43.174.40 -j ACCEPT
sudo iptables -A OUTPUT -d 192.195.204.216 -j ACCEPT
sudo iptables -A OUTPUT -d 52.10.249.207 -j ACCEPT
sudo iptables -A FORWARD -d 52.43.174.40 -j ACCEPT
sudo iptables -A FORWARD -d 192.195.204.216 -j ACCEPT
sudo iptables -A FORWARD -d 52.10.249.207 -j ACCEPT
sudo iptables -A FORWARD -s 52.43.174.40 -j ACCEPT
sudo iptables -A FORWARD -s 192.195.204.216 -j ACCEPT
sudo iptables -A FORWARD -s 52.10.249.207 -j ACCEPT
sudo iptables-save > /raspi_secure/firewall.rules

There is also beta release in the git working local tree of the image. You can give that a look-see by SSH'ing in and running.

cd /git
git checkout working
sudo ./scripts/copy_to_sysdirs.sh -a

User guide

Start RaspiPass

Insert the Micro-SD card into your powered-down Raspberry Pi 3 (with ethernet connected) and turn on.

Allow the device to boot up (the first boot may take a little while as it may need to perform some initial storage fiddling).

Open http://raspipass/ to access the Web GUI and adjust settings as desired.

From here the device should run automatically. You can force the script to start, or shut down the device by using the buttons under the "Admin Tasks" tab in the Web GUI.

Useful links

FAQ

Q. What are the login details?

User: raspi
Password: pinchie

Q.Does this work on a Raspberry Pi 2?

Not out-of-the-box. The software is set up to use the Raspberry Pi 3's on-board wireless chip, while the Pi 2 has no on-board wifi. If you can find a USB wifi adapter that will let you create an AP and change the MAC address, you may be able to use the image to get you most of the way, and you'll just have to set up your wifi adapter to work on wlan0. Results will vary from adapter to adapter, but others have succeeded using this software, a Pi2, and the right wireless adapter.

Q. How secure is the wireless network this creates?

Hopefully, bloody secure.

The iptables configuration is set to allow only traffic necessary for your 3DS to jump onto the network, get an address, and talk specifically to the Nintendo StreetPass Relay servers. I do invite you to jump onto the network with another device and do some penetration testing - I'm always anxious to try and close any loopholes I may have left open. So far in my testing I haven't found any major security issues.

Q. Why can't I get your image onto a 2Gb card?

While I've been through a couple of "2Gb" cards trying to find the smallest. After a few attempts and suggestions I'm currently using a Kingston 2Gb with a total size of 1,954,545,664 bytes.

What I've learned is that cards of the same labelled size are not actually the same, and can vary from brand to brand. I aim to keep the image as small as possible, but if you find a "2Gb" card that's smaller than the image requires, you may have to use a 4Gb. Alternatively, I'm very willing to trade our 2Gb cards - my larger one for your smaller one - in order to make a more compatible image.

Q. Can I install manually, or do I have to use the disk image?

Well there's nothing stopping you installing manually.

There is a deprecated guide here, but be sure to download the most recent firewall configuration from the GitHub repo, or you won't get any StreetPass hits.

Q. I have a router/laptop/other device I can create an access point with...can't I just use that?

Absolutely. As long as you can change the MAC address and set the SSID to the correct name you can do this yourself.

See the Homepass Site for the info you'll need.

Q. Can I use RaspiPass with RetroPie/XBMC/other Raspberry Pi software?

Yes and no.

While RaspiPass is at its heart just a glorified BASH script, the way it uses the network interfaces may cause some issues with other software. It 'bridges' the wired and wireless interfaces into a single interface - br0. When the wireless interface is brought down to turn off a hotspot there can be a few seconds of transmission delay while the OS sorts itself out. By all means try it, but I can't guarantee flawless performance of other software.

The strict firewall setting can also be a hindrance, but if you're willing to sacrifice the security of the open network for co-functionality with other Pi software then that's up to you - I just try to make it as secure as possible at the time of distribution. Any decisions you make from there are up to you. :)

Screenshots

raspipass3.png

Media

How to Get Free StreetPass With Raspipass | Raspberry Pi | From Start To Finish (by HighTeckMan).

Changelog

beta

  • A better back-end for the Web GUI.
  • Locale changing from the Web GUI.

0.7.4 2016/12/12

Log & live config location changes:

  • Moved almost every dynamic RaspiPass file (eg logs, dynamic config) to /var/raspipass.
  • Configured two tmpfs drives mounted on /var/raspipass and /var/log/apache2 in order to reduce SD use.
  • Added configuration in copy_to_sysdirs.sh to create these mount points in fstab if they do not exist (reboot required after).

Script changes:

  • Standardised scripts with parameters - all scripts now have an -h parameter.
  • Improved update script.
  • Altered copy_to_sysdirs.sh to reference a csv file /git/scripts/filepermissions to use as a source when copying & setting permissions.
  • Added more logs to /raspi_secure/clear_logs.sh.
  • Cleaned up output of clear_logs.sh and set_defaults.sh.
  • Removed copy_to_gitdir.sh - this was only required when Git wasn't used properly.

Other changes:

  • Removed lots of commented out lines of code that were used during initial debugging.
  • Set up daily downloading of latest version file from GitHub raw servers (for update checking).
  • Added notification of required reboot to Web GUI (triggered by presence of /var/raspipass/reboot - message is contents of first line.
  • Added daily download task (at 00:00:00) of latest master 'version' file from GitHub server to check for latest version file.
  • Permitted access to GitHub raw server to allow above download.

External links

Advertising: