Provides the ability to interact with icloud.com's web api. The authentication flow grants trust for future logins as well as auth for all icloud.com web applications.
An iCloud+ plan is required in order to use some features of the client, such as the Hide My Email service.
Please note that HME email generation is limited to 5 emails per hour, and up to 750 total emails per account, or if in the case of a family account, 750 per family member.
| Module | Status |
|---|---|
| Hide My Email | ✔ |
✔ |
|
| Find My | 🔨 |
| Photos | 🔨 |
| iCloud Drive |
go get github.com/Johnw7789/Go-iClient
In this example we are waiting for a OTP from user input from the console. However, this could be implemented in other ways. For example, if using this package as part of a project with a UI, a popup input modal could be opened to wait for the OTP, and then send the OTP back through the channel to the thread.
// * Create a new iClient with account username and password, do not sniff with local proxy
iclient, err := icloud.NewClient("username", "password", false)
if err != nil {
log.Fatal(err)
}
go func() {
// * Create iCloud session and authenticate to use HME service
err := iclient.Login()
if err != nil {
log.Fatal(err)
}
// do stuff after auth here e.g. gen hme, fetch mail etc
}()
var otpInput string
fmt.Print("Enter OTP: ")
fmt.Scanln(&otpInput)
iclient.OtpChannel <- otpInputlabel := "email 123"
note := "this email is a test email"
// * Generate a new HME email
emailAddress, err := iclient.ReserveHME(label, note)
if err != nil {
log.Fatal(err)
}emails, err := iclient.RetrieveHMEList()
if err != nil {
log.Fatal(err)
}
for _, email := range emails {
fmt.Println(email.Hme)
}The anonymous ID is used for reactivation/deactivation/deletion and can be retrieved from the HmeEmail struct as part of the HMEListResp struct.
anonymousId := "anonymousId"
success, err := iclient.DeactivateHME(anonymousId)
if err != nil {
log.Fatal(err)
}success, err = iclient.ReactivateHME(anonymousId)
if err != nil {
log.Fatal(err)
}In order to delete an email it first must be deactivated.
success, err = iclient.DeactivateHME(anonymousId)
if err != nil {
log.Fatal(err)
}
success, err = iclient.DeleteHME(anonymousId)
if err != nil {
log.Fatal(err)
}maxResults := 50
beforeTimestamp := 0 // if set to 0, it will not be used in the query and instead set as a blank string
mailResponse, err := iclient.RetrieveMailInbox(maxResults, beforeTimestamp)
if err != nil {
log.Fatal(err)
}
for _, message := range mailResponse.ThreadList {
fmt.Println(message.Senders)
fmt.Println(message.Subject)
fmt.Println(message.ThreadID)
fmt.Println()
}threadId := "threadId"
mailMetadata, err := iclient.GetMessageMetadata(threadId)
if err != nil {
log.Fatal(err)
}
message, err := iclient.GetMessage(mailMetadata.UID)
if err != nil {
log.Fatal(err)
}
for _, part := range message.Parts {
// * Print the content of the email, or the body html
fmt.Println(part.Content)
}The UID can only be obtained from the mail metadata, which is why you must get the message metadata first.
threadId := "threadId"
mailMetadata, err := iclient.GetMessageMetadata(threadId)
if err != nil {
log.Fatal(err)
}
success, err := iclient.DeleteMail(mailMetadata.UID)
if err != nil {
log.Fatal(err)
}fromEmail := "test@icloud.com"
toEmail := "test@icloud.com"
subject := "Test Email"
textBody := "This is a test email"
body := "<html><body><h1>This is a test email</h1></body></html>"
uid, err := iclient.DraftMail(fromEmail, toEmail, subject, textBody, body)
if err != nil {
log.Fatal(err)
}
// * Send the email
success, err := iclient.SendDraft(uid)
if err != nil {
log.Fatal(err)
}