diff --git a/docs/backupandrestore.md b/docs/backupandrestore.md index 8cc32c8..f30e5bc 100644 --- a/docs/backupandrestore.md +++ b/docs/backupandrestore.md @@ -2,7 +2,10 @@ # Backup & Restore ::: info OpenBubbles does not support iCloud backups. + OpenBubbles **only** supports local backup and restore. (Only attachments under 16mb saved) + +OpenBubbles cannot import messages from BlueBubbles. ::: diff --git a/docs/faq.md b/docs/faq.md index 3fec8d7..11e3e79 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -1,6 +1,54 @@ # Frequently Asked Questions +## Is OpenBubbles safe to use? + +Everything happens locally, on your phone. Anything that happens is strictly between you and Apple. An immense effort has been made to ensure a reliable and safe experience. That being said, iMessage is a complex and changing system, and every situation cannot be predicted. Most issues will only affect OpenBubbles, and will not affect other devices or your account. In extremely rare cases, your account may be temporarily (day or two) or permanently blocked. In permanent cases, a call with Apple support will usually lift the block. +::: warning +You are responsible for who you share your hardware identifiers with. If someone uses your hardware identifiers to send mass spam, your device _**will**_ be blocked, and you will only have yourself to blame. If you share one device with over 20 users, you may experience issues. +::: + +## Can I use a VM with OpenBubbles? +::: danger +**Do not use data from a virtual machine.** **No**, it doesn't matter that iMessage works in the VM. **No**, your generated data is not "special" or "approved". Apple *knows* your hardware info is phony and any success you on the VM get is Apple being nice. Register another time with OB and there is a decent chance your account will be banned. Don't say I didn't warn you. +::: + +## Can OpenBubbles import existing messages? +See [Backup and Restore](/docs/backupandrestore) + +## Does OpenBubbles support "X" feature? + +### FindMy + +Access the Find My page from the top 3 dots on the main screen. If no Find My option appears, you need to re-log in. Choose "Change Hardware" in settings. +* AirTags are not supported +* Sharing live location with other users is not supported +* Receiving shared locations through Find My and iMessage is supported +* Tracking other devices is supported + +### FaceTime Web + +Incoming FaceTime calls should ring automatically. You can see recent FaceTime calls or place one yourself by opening the FaceTime under the three-dot menu. +SharePlay and screen sharing aren't available in FaceTime on the web. + +### Shared albums +You can only contribute media to shared albums you are invited to. Creating shared albums is not supported at the moment. + +### Importing messages +See [Backup and Restore](/docs/backupandrestore) + +### Scheduling messages +To schedule a message, go to the desired chat, press the plus icon and select "Send Later". + +### Message effects +To send a message effect, press and hold the send button after you have inputted your message. + +### Text formatting +To use text formatting. Select your text and tap the desired formatting option. + +### Android Auto +OpenBubbles does not support Android Auto. + ## What is "Hardware Info"? During iMessage activation, your machine's hardware identifiers (serial number, board ID, model, etc.) are sent to Apple for validation. @@ -10,10 +58,6 @@ OpenBubbles requires valid machine identifiers to send to Apple during activatio See [activation](/quickstart.html#activate-openbubbles) -## Can OpenBubbles import existing messages? -* If you have a previous OpenBubbles message backup, yes. To create or restore one, go to Settings -> Backup & Restore -> Messages Backups. -* If you do not have an OpenBubbles message backup, not at this time. OpenBubbles cannot backfill messages from iCloud. - ## What if I do not have access to a Mac? If you don't have access to a Mac, ask a friend to share their code with you. They can share it from the hardware info app on the Mac, or from settings inside OpenBubbles. One Mac can be used by up to 20 users (unlimited logins). @@ -29,15 +73,8 @@ No! Once you have setup OpenBubbles, feel free to turn off, discard, or do anyth * Expire after 48 hours (text codes only) * Cannot be shared to other users after completing setup. -## Is OpenBubbles safe to use? - -Everything happens locally, on your phone. Anything that happens is strictly between you and Apple. An immense effort has been made to ensure a reliable and safe experience. That being said, iMessage is a complex and changing system, and every situation cannot be predicted. Most issues will only affect OpenBubbles, and will not affect other devices or your account. In extremely rare cases, your account may be temporarily (day or two) or permanently blocked. In permanent cases, a call with Apple support will usually lift the block. -::: warning -You are responsible for who you share your hardware identifiers with. If someone uses your hardware identifiers to send mass spam, your device _**will**_ be blocked, and you will only have yourself to blame. If you share one device with over 20 users, you may experience issues. -::: -## I am having issues logging into my Apple Account -To potentially resolve this issue, go to https://account.apple.com/, and delete any duplicate devices and try again. - +## Will the Mac I use have access to my account? +No. OpenBubbles impersonates the Mac, and the Mac is not even aware of the login and doesn't have any of the associated keys. If you see the Mac logged in on your Apple ID page, you are seeing OpenBubbles. ## Disable Foreground Service Notification This notification is not needed for OpenBubbles to function. @@ -50,60 +87,31 @@ To disable, either: If you are using a Samsung Device and do not see notification categories you have to enable the "Manage notification categories for each app" option. To do this you have to go into Settings -> Notifications -> Advanced Settings -> toggle manage notification categories for each app. -All the methods should end on a page like this: +
+All the methods should end on a page like this: +
![Foreground service](/foreground.png) + +
-## Can I use a VM with OpenBubbles? -::: danger -**Do not use data from a virtual machine.** **No**, it doesn't matter that iMessage works in the VM. **No**, your generated data is not "special" or "approved". Apple *knows* your hardware info is phony and any success you on the VM get is Apple being nice. Register another time with OB and there is a decent chance your account will be banned. Don't say I didn't warn you. -::: - -## Will the Mac I use have access to my account? -No. OpenBubbles impersonates the Mac, and the Mac is not even aware of the login and doesn't have any of the associated keys. If you see the Mac logged in on your Apple ID page, you are seeing OpenBubbles. ## Can I register my phone number with OpenBubbles? If you have an iPhone running the relay app, yes. The phone must stay online at all times. Enter the relay code on the hardware identifier screen, and you will be prompted to register your number. Please refer to the [Phone Number Registration](pnr) page for more information. -## Does OpenBubbles work with FindMy? - -Yes! Access the Find My page from the top 3 dots on the main screen. If no Find My option appears, you need to re-log in. Choose "Change Hardware" in settings. -* AirTags are not supported -* Sharing live location with other users is not supported -* Receiving shared locations through Find My and iMessage is supported -* Tracking other devices is supported - -## Can I create shared albums? -No, at this time only receiving is supported. However, you can contribute media to shared albums you are invited to. - -## Does OpenBubbles work with FaceTime? - -Yes! Incoming FaceTime calls should ring automatically. You can see recent FaceTime calls or place one yourself by opening the FaceTime under the three-dot menu. +## I am having issues logging into my Apple Account +See [troubleshooting](/docs/troubleshooting.html#i-am-having-issues-logging-into-my-apple-account) ## Why are contacts I know are using iMessage showing up green? - -This means you are throttled by Apple. Wait a few hours/days and try again. -* If you recently registered, this can be normal. -* If you have texted many people (group chat or otherwise) you may have to wait a few days or weeks for Apple to raise your limit. +See [troubleshooting](/docs/troubleshooting.html#why-are-contacts-i-know-are-using-imessage-showing-up-green) ## I see "Verification Failed" under some messages. What does this mean? -This indicates OpenBubbles could not verify the identity of the sender when the message was received. This can be caused for a few reasons: -* You had a poor connection at the time and Apple's keyserver could not be contacted -* You are being rate-limited by Apple -* \[Highly unlikely\] An attacker has compromised APS (but not the keyserver) and is attempting to send a message from an identity that isn't theirs. +See [troubleshooting](/docs/troubleshooting.html#i-see-verification-failed-under-some-messages-what-does-this-mean) ## Why can't I send or receive messages? - -* Running clear identity cache (Go to Settings -> Developer Tools) - This may help with sending messages. -* Make sure iMessage and Facetime is disabled and you are logged out of iCloud if you are using an iPhone. -* You are deregistered - Check your registration status and renewal time in your profile settings and check your registration method and try again. -* Advanced Data Protection is enabled - Disable this option -* Contact Key Verification is enabled - Disable this option -* Your Apple Account/Hardware has been throttled/banned/blocked by Apple - Visit this [site](https://rentry.org/applebans) to learn more. You may need to create a new account. - -Contact us on [Discord](https://discord.gg/98fWS4AQqN) if issues persist. +See [troubleshooting](/docs/troubleshooting.html#i-can-t-send-or-receive-messages) ## Why can't I see my messages sent on OpenBubbles on other Apple devices, even though my Apple Account is linked? -This is a known issue and fixes itself after 24 hours. \ No newline at end of file +This is a known issue and fixes itself after 24 hours. diff --git a/docs/pnr.md b/docs/pnr.md index b2ef405..e40acbf 100644 --- a/docs/pnr.md +++ b/docs/pnr.md @@ -9,7 +9,7 @@ Learn how to get your phone number working on iMessage. The app will default to You can also choose to skip logging in with Apple Account. This may lead to less issues in some cases. ## Pre-Setup | Do this first -Make sure iMessage andFacetime is disabled on your iPhone. You also need to disable Advanced Data Protection and Contact Key Verification. +Make sure iMessage and Facetime is disabled on your iPhone. You also need to disable Advanced Data Protection and Contact Key Verification. Log out of any Apple Account on the device. OpenBubbles does not support login via app-specific passwords and hardware keys. ## Sim / eSim Swaping Methods diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index 9b628a6..2be7d66 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -3,20 +3,38 @@ ## My contacts aren't showing When you first install OpenBubbles, your contacts may not be properly displayed. In order to fix this, restart your phone. +The windows app currently does not show contacts. As an alternative, you can use the "Change Chat Avatar" option in the details page of your chat to identify your contacts. + + +## Why are contacts I know are using iMessage showing up green? + +This means you are throttled by Apple. Wait a few hours/days and try again. +* If you recently registered, this can be normal. +* If you have texted many people (group chat or otherwise) you may have to wait a few days or weeks for Apple to raise your limit. + + ## I can't send or receive messages * Running clear identity cache (Go to Settings -> Developer Tools) - This may help with sending messages. * Make sure iMessage and Facetime is disabled and you are logged out of iCloud if you are using an iPhone. * You are deregistered - Check your registration status and renewal time in your profile settings and check your registration method and try again. +* Start a new conversation with contact * Advanced Data Protection is enabled - Disable this option * Contact Key Verification is enabled - Disable this option * Your Apple Account/Hardware has been throttled/banned/blocked by Apple - Visit this [site](https://rentry.org/applebans) to learn more. You may need to create a new account. +* Make sure your iDevice can use iMessage. If your device cannot use iMessage, OpenBubbles will not work. Contact us on [Discord](https://discord.gg/98fWS4AQqN) if issues persist. ## I keep getting sent back to the login screen * Make sure you are logged out of iCloud on the relay device (if applicable) -* Delete duplicate device logins on account.apple.com +* Delete duplicate device logins on https://account.apple.com + +## I am having issues logging into my Apple Account +To potentially resolve this issue, go to https://account.apple.com/, and delete any duplicate devices and try again. + +OpenBubbles does not support login via app-specific passwords and hardware keys +Please use a email and password to login. ## Debug relay issues (device offline/code not found) * Make sure your device is powered on. @@ -29,6 +47,13 @@ Contact us on [Discord](https://discord.gg/98fWS4AQqN) if issues persist. ## I can't see sent messages on other Apple devices, even though my Apple Account is linked * This is a known issue and fixes itself after 24 hours. +## I see "Verification Failed" under some messages. What does this mean? +This indicates OpenBubbles could not verify the identity of the sender when the message was received. This can be caused for a few reasons: +* You had a poor connection at the time and Apple's keyserver could not be contacted +* You are being rate-limited by Apple +* \[Highly unlikely\] An attacker has compromised APS (but not the keyserver) and is attempting to send a message from an identity that isn't theirs. +## Mac-Hardware-Info does not work +* Update to High Sierra or newer, if your device does not compatible with newer versions of MacOS visit https://dortania.github.io/OpenCore-Legacy-Patcher/ to see how to update to a newer version of MacOS.