Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,16 @@ jobs:
path: screenshots
if-no-files-found: ignore

# Store screenshots with captions, in the languages of the Store listings (store/listing).
- name: Store screenshots
continue-on-error: true
timeout-minutes: 5
shell: pwsh
run: |
Start-Process publish/win-x64/Earlo.exe -ArgumentList '--render-preview', "$PWD\screenshots-nl", '--lang', 'nl' -Wait
./tools/make-store-screenshots.ps1 -Renders screenshots -Lang en -Out store-screenshots/en
./tools/make-store-screenshots.ps1 -Renders screenshots-nl -Lang nl -Out store-screenshots/nl

- name: Store package
shell: pwsh
run: |
Expand All @@ -108,7 +118,9 @@ jobs:
- uses: actions/upload-artifact@v4
with:
name: store
path: Earlo-store.msixbundle
path: |
Earlo-store.msixbundle
store-screenshots

driver:
runs-on: windows-2022
Expand Down Expand Up @@ -165,3 +177,40 @@ jobs:
name: Earlo ${{ github.ref_name }}
files: '*.zip'
generate_release_notes: true

# Sends the release to the Microsoft Store as a new submission (package only; the listing stays as it is
# in Partner Center). Needs the four PARTNER_CENTER_* secrets, see docs/microsoft-store.md; without them
# this job does nothing.
store:
if: startsWith(github.ref, 'refs/tags/v')
needs: app
runs-on: windows-latest
env:
TENANT_ID: ${{ secrets.PARTNER_CENTER_TENANT_ID }}
SELLER_ID: ${{ secrets.PARTNER_CENTER_SELLER_ID }}
CLIENT_ID: ${{ secrets.PARTNER_CENTER_CLIENT_ID }}
CLIENT_SECRET: ${{ secrets.PARTNER_CENTER_CLIENT_SECRET }}
STORE_APP_ID: 9NB1SVRN9Z6T
steps:
- name: Check Partner Center secrets
id: secrets
shell: pwsh
run: |
$ready = $env:TENANT_ID -and $env:SELLER_ID -and $env:CLIENT_ID -and $env:CLIENT_SECRET
"ready=$($ready.ToString().ToLower())" >> $env:GITHUB_OUTPUT
if (-not $ready) { Write-Host 'No Partner Center secrets; upload Earlo-store.msixbundle in Partner Center yourself.' }

- uses: actions/download-artifact@v4
if: steps.secrets.outputs.ready == 'true'
with:
name: store

- uses: microsoft/microsoft-store-apppublisher@v1.4
if: steps.secrets.outputs.ready == 'true'

- name: Submit to the Microsoft Store
if: steps.secrets.outputs.ready == 'true'
shell: pwsh
run: |
msstore reconfigure --tenantId $env:TENANT_ID --sellerId $env:SELLER_ID --clientId $env:CLIENT_ID --clientSecret $env:CLIENT_SECRET
msstore publish Earlo-store.msixbundle --appId $env:STORE_APP_ID
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,5 @@ preview/
TestResults/
earlo-log.txt
src/Earlo.App/DriverPackage/
store-screenshots/
renders/
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
<a href="../../releases"><img src="https://img.shields.io/github/downloads/kylianxdev/Earlo/total?color=0a84ff" alt="Downloads"></a>
<img src="https://img.shields.io/badge/Windows-10%20%7C%2011-1c1c1e" alt="Windows 10 and 11">
<a href="LICENSE"><img src="https://img.shields.io/github/license/kylianxdev/Earlo?color=6e6e73" alt="MIT license"></a>
<a href="https://kylianxdev.github.io/Earlo/"><img src="https://img.shields.io/badge/website-kylianxdev.github.io%2FEarlo-34c759" alt="Earlo website"></a>
</p>

<p align="center">
Expand Down
Empty file added docs/.nojekyll
Empty file.
200 changes: 200 additions & 0 deletions docs/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,200 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Earlo: AirPods battery and ear detection for Windows 11 and 10</title>
<meta name="description" content="See your AirPods battery on Windows like on an iPhone: a popup when you open the case, live battery levels in the tray, automatic ear detection and a fix for muffled sound. Also for Beats and Galaxy Buds. Free and open source.">
<link rel="canonical" href="https://kylianxdev.github.io/Earlo/">
<link rel="icon" type="image/png" href="icon.png">
<meta name="theme-color" content="#f5f5f7" media="(prefers-color-scheme: light)">
<meta name="theme-color" content="#111113" media="(prefers-color-scheme: dark)">
<meta property="og:type" content="website">
<meta property="og:title" content="Earlo: AirPods battery and ear detection for Windows">
<meta property="og:description" content="The iPhone battery popup for Windows: live battery levels, ear detection and stereo sound for AirPods, Beats and Galaxy Buds.">
<meta property="og:url" content="https://kylianxdev.github.io/Earlo/">
<meta property="og:image" content="https://kylianxdev.github.io/Earlo/screenshots/all-models.png">
<meta name="twitter:card" content="summary_large_image">
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "SoftwareApplication",
"name": "Earlo",
"alternateName": "PodPilot",
"description": "Battery popup, live battery levels, automatic ear detection and a fix for muffled sound for AirPods, Beats and Samsung Galaxy Buds on Windows.",
"operatingSystem": "Windows 10, Windows 11",
"applicationCategory": "UtilitiesApplication",
"url": "https://kylianxdev.github.io/Earlo/",
"downloadUrl": "https://github.com/kylianxdev/Earlo/releases/latest",
"softwareHelp": "https://github.com/kylianxdev/Earlo#questions",
"image": "https://kylianxdev.github.io/Earlo/screenshots/popup-airpods-pro.png",
"screenshot": "https://kylianxdev.github.io/Earlo/screenshots/all-models.png",
"license": "https://github.com/kylianxdev/Earlo/blob/main/LICENSE",
"isAccessibleForFree": true,
"offers": { "@type": "Offer", "price": "0", "priceCurrency": "EUR" },
"author": { "@type": "Person", "name": "Kylian de Groot" }
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "How do I see my AirPods battery level on Windows?",
"acceptedAnswer": { "@type": "Answer", "text": "Start Earlo and open the AirPods case near your PC. A popup shows the left and right earbud and the case, like on an iPhone, and the tray icon shows the levels at any time." }
},
{
"@type": "Question",
"name": "Why do my AirPods sound bad on Windows?",
"acceptedAnswer": { "@type": "Answer", "text": "As soon as an app opens the earbuds' microphone (Teams, Discord, Zoom, a browser), Windows switches them from stereo to the Hands-Free profile, which is mono and muffled like a phone call. In Earlo, turn on Settings > Sound quality > \"Turn off the earbuds' microphone for the best sound\". They then always play in stereo; calls use your PC's microphone instead." }
},
{
"@type": "Question",
"name": "Does AirPods ear detection work on Windows?",
"acceptedAnswer": { "@type": "Answer", "text": "Yes. Take an earbud out and Earlo pauses Spotify, YouTube, Netflix or any other app in the Windows media controls; put it back in and it plays on." }
},
{
"@type": "Question",
"name": "Does Earlo work with Beats and Galaxy Buds?",
"acceptedAnswer": { "@type": "Answer", "text": "Yes. Beats earbuds and headphones work like AirPods. Samsung Galaxy Buds, from the 2019 Galaxy Buds to the Buds3 Pro and Buds Core, show exact battery levels once they are connected to your PC." }
},
{
"@type": "Question",
"name": "Is Earlo free?",
"acceptedAnswer": { "@type": "Answer", "text": "Yes, Earlo is free and open source on GitHub. A Microsoft Store version with automatic updates supports its development." }
}
]
}
</script>
<style>
:root {
--bg: #f5f5f7; --card: #ffffff; --text: #1d1d1f; --muted: #5f5f66; --line: #e2e2e7;
--accent: #0a84ff; --accent-text: #ffffff; --green: #1f9d47;
}
@media (prefers-color-scheme: dark) {
:root { --bg: #111113; --card: #1c1c1f; --text: #f5f5f7; --muted: #a1a1aa; --line: #2c2c31; --green: #34c759; }
}
* { box-sizing: border-box; }
body {
margin: 0; background: var(--bg); color: var(--text); line-height: 1.55;
font-family: "Segoe UI Variable Text", "Segoe UI", system-ui, -apple-system, sans-serif;
}
a { color: var(--accent); }
main, footer { max-width: 1040px; margin: 0 auto; padding: 0 16px; }
header { text-align: center; padding: 56px 16px 24px; }
header img.icon { width: 88px; height: 88px; }
.brand { font-size: 20px; font-weight: 600; margin: 8px 0 0; }
h1 { font-size: clamp(30px, 5vw, 48px); line-height: 1.12; margin: 12px auto; max-width: 820px; letter-spacing: -0.02em; }
.lead { font-size: 19px; color: var(--muted); max-width: 720px; margin: 0 auto; }
.buttons { display: flex; flex-wrap: wrap; gap: 12px; justify-content: center; margin: 28px 0 8px; }
.button {
display: inline-block; padding: 12px 22px; border-radius: 999px; font-weight: 600; text-decoration: none;
border: 1px solid var(--line); color: var(--text); background: var(--card);
}
.button.primary { background: var(--accent); border-color: var(--accent); color: var(--accent-text); }
.small { font-size: 14px; color: var(--muted); }
.shots { display: flex; gap: 16px; justify-content: center; flex-wrap: wrap; margin: 32px 0; }
.shots img { width: min(300px, 100%); height: auto; }
section { margin: 56px 0; }
h2 { font-size: clamp(24px, 3.4vw, 32px); letter-spacing: -0.01em; margin: 0 0 16px; }
.grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); gap: 16px; }
.card { background: var(--card); border: 1px solid var(--line); border-radius: 16px; padding: 20px; }
.card h3 { margin: 0 0 6px; font-size: 18px; }
.card p { margin: 0; color: var(--muted); }
.wide { width: 100%; height: auto; border-radius: 12px; }
.models { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 16px; }
.models ul { margin: 0; padding-left: 18px; color: var(--muted); }
details { background: var(--card); border: 1px solid var(--line); border-radius: 12px; padding: 14px 18px; margin: 10px 0; }
summary { cursor: pointer; font-weight: 600; }
details p { color: var(--muted); margin: 10px 0 0; }
.fix { border-left: 4px solid var(--green); }
footer { padding: 24px 16px 48px; color: var(--muted); font-size: 13px; border-top: 1px solid var(--line); }
</style>
</head>
<body>
<header>
<img class="icon" src="icon.png" alt="Earlo icon" width="88" height="88">
<p class="brand">Earlo</p>
<h1>AirPods battery and ear detection for Windows</h1>
<p class="lead">The iPhone battery popup for Windows 11 and 10. Live battery levels, automatic ear detection, one-click connect
and stereo sound in every app, for AirPods, Beats and Samsung Galaxy Buds. Free, open source, no account.</p>
<div class="buttons">
<a class="button primary" href="https://github.com/kylianxdev/Earlo/releases/latest">Download for Windows</a>
<a class="button" href="https://github.com/kylianxdev/Earlo#microsoft-store">Microsoft Store</a>
<a class="button" href="https://github.com/kylianxdev/Earlo">Source on GitHub</a>
</div>
<p class="small">A single Earlo.exe for Windows 10 (2004 or newer) and Windows 11, x64 and ARM. Earlo was called PodPilot before.</p>
</header>

<main>
<div class="shots">
<img src="screenshots/popup-airpods-pro.png" width="300" alt="Earlo popup with the battery of AirPods Pro: left, right and case">
<img src="screenshots/popup-ear-detection.png" width="300" alt="Earlo popup showing which AirPods earbud is in your ear">
<img src="screenshots/popup-galaxy-buds.png" width="300" alt="Earlo popup with the battery of Samsung Galaxy Buds2 Pro">
</div>

<section>
<h2>Everything your iPhone shows, now on your PC</h2>
<div class="grid">
<div class="card"><h3>Battery popup</h3><p>Open the case near your PC and see the left earbud, the right earbud and the case, with charging state.</p></div>
<div class="card"><h3>Battery in the tray</h3><p>Live battery levels of your AirPods and headphones next to the clock, with low battery warnings.</p></div>
<div class="card"><h3>Automatic ear detection</h3><p>Take an earbud out and Spotify, YouTube or Netflix pauses. Put it back in and it plays on.</p></div>
<div class="card"><h3>One-click connect</h3><p>Connect or disconnect from the popup, or let the earbuds switch to your PC when you put them in.</p></div>
<div class="card"><h3>"Connected" notice</h3><p>A small card in the top-right corner when your earbuds connect, with their battery levels.</p></div>
<div class="card"><h3>Noise control</h3><p>Off, Noise Cancellation, Transparency and Adaptive, with the experimental driver in the GitHub version.</p></div>
</div>
</section>

<section class="card fix">
<h2>Fix the muffled sound of AirPods on Windows</h2>
<p>Do your AirPods sound muffled, flat or mono on Windows as soon as you open Teams, Discord or Zoom? When an app opens the
earbuds' microphone, Windows switches them from stereo music to the Hands-Free profile, which sounds like a phone call.
Earlo turns that off with one switch, so your earbuds always play in stereo. Calls then use your PC's microphone, and you
can switch it back at any time.</p>
</section>

<section>
<h2>Works with AirPods, Beats and Galaxy Buds</h2>
<img class="wide" src="screenshots/all-models.png" width="1040" height="347" alt="Earlo popups for AirPods 2, AirPods 3, AirPods 4, AirPods Max, AirPods Pro, Beats Fit Pro, Beats Flex, Beats Studio Buds, Beats Studio Pro, Galaxy Buds2 Pro and Powerbeats Pro" loading="lazy">
<div class="models" style="margin-top:16px">
<div class="card"><h3>AirPods</h3><ul>
<li>AirPods 1st, 2nd and 3rd generation</li><li>AirPods 4 and AirPods 4 (ANC)</li>
<li>AirPods Pro, AirPods Pro 2 (Lightning and USB-C), AirPods Pro 3</li><li>AirPods Max (Lightning and USB-C)</li></ul></div>
<div class="card"><h3>Beats</h3><ul>
<li>Powerbeats Pro, Powerbeats Pro 2, Powerbeats, Powerbeats3</li><li>Beats Fit Pro, Studio Buds, Studio Buds +, Solo Buds</li>
<li>Beats Flex, BeatsX</li><li>Beats Solo3, Solo Pro, Solo 4, Studio3, Studio Pro</li></ul></div>
<div class="card"><h3>Samsung Galaxy Buds</h3><ul>
<li>Galaxy Buds, Buds+, Buds Live, Buds Pro</li><li>Galaxy Buds2, Buds2 Pro, Buds FE, Buds Core</li>
<li>Galaxy Buds3, Buds3 Pro, Buds3 FE</li></ul></div>
</div>
</section>

<section>
<h2>Questions</h2>
<details open><summary>How do I see my AirPods battery level on Windows?</summary>
<p>Start Earlo and open the AirPods case near your PC. A popup shows the left and right earbud and the case, like on an iPhone,
and the tray icon shows the levels at any time.</p></details>
<details><summary>Why do my AirPods sound bad on Windows?</summary>
<p>As soon as an app opens the earbuds' microphone (Teams, Discord, Zoom, a browser), Windows switches them from stereo to the
Hands-Free profile, which is mono and muffled like a phone call. In Earlo, turn on Settings &gt; Sound quality &gt; "Turn off the
earbuds' microphone for the best sound". They then always play in stereo; calls use your PC's microphone instead.</p></details>
<details><summary>Does AirPods ear detection work on Windows?</summary>
<p>Yes. Take an earbud out and Earlo pauses Spotify, YouTube, Netflix or any other app in the Windows media controls;
put it back in and it plays on.</p></details>
<details><summary>Does Earlo work with Beats and Galaxy Buds?</summary>
<p>Yes. Beats earbuds and headphones work like AirPods. Samsung Galaxy Buds, from the 2019 Galaxy Buds to the Buds3 Pro and
Buds Core, show exact battery levels once they are connected to your PC.</p></details>
<details><summary>Is Earlo free?</summary>
<p>Yes, Earlo is free and open source on GitHub. A Microsoft Store version with automatic updates supports its development.</p></details>
</section>
</main>

<footer>
<p>Earlo is open source under the MIT license. No account, no telemetry: <a href="https://github.com/kylianxdev/Earlo/blob/main/PRIVACY.md">privacy policy</a>.</p>
<p>AirPods and Beats are trademarks of Apple Inc. Galaxy Buds is a trademark of Samsung Electronics Co., Ltd.
Earlo is not affiliated with Apple or Samsung.</p>
</footer>
</body>
</html>
Loading
Loading