Skip to content

Repository files navigation

NetworkSwitch - Mac 网络自动切换工具

NetworkSwitch - Automatic Network Switching Tool for Mac

  • 一款简洁的 macOS 状态栏应用,可以在检测到有线网络(以太网)接入时自动关闭 Wi-Fi,在有线网络断开时自动恢复 Wi-Fi 连接。
  • A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

🚀 主要功能 (Features)

  • ✅ 自动切换 (Automatic Switching):
    • 检测到以太网连接时,自动关闭 Wi-Fi。
    • When an Ethernet connection is detected, Wi-Fi is automatically turned off.
    • 以太网连接断开时,自动重新开启 Wi-Fi。
    • When the Ethernet connection is lost, Wi-Fi is automatically re-enabled.
  • ✅ 状态栏菜单 (Menu Bar Integration):
    • 所有核心功能都集成在状态栏菜单中,方便快速操作。
    • All core functions are integrated into the menu bar for quick access.
  • ✅ 开机自启 (Launch at Login):
    • 可在偏好设置中设为开机自动启动。
    • Can be configured to launch automatically at login via preferences.
  • ✅ 实时状态 (Real-time Status):
    • 状态栏图标和菜单会实时显示当前网络连接状态。
    • The menu bar icon and menu display the current network status in real time.
  • ✅ 系统通知 (System Notifications):
    • 每当网络状态发生自动切换时,都会收到系统通知。
    • Receive a system notification whenever an automatic network switch occurs.

💻 如何安装 (Installation)

  1. 下载应用 (Download the App)

    • 前往项目的 Releases 页面。
    • Go to the project's Releases page.
    • 下载最新版本的 NetworkSwitch-vX.X.X.dmg 文件。
    • Download the latest NetworkSwitch-vX.X.X.dmg file.
  2. 安装 (Install)

    • 双击打开 .dmg 文件。
    • Double-click the downloaded .dmg file.
    • NetworkSwitch.app 图标拖拽到 Applications (应用程序) 文件夹中。
    • Drag the NetworkSwitch.app icon into your Applications folder.
  3. 首次运行 (First Launch)

    • 首次打开应用时,如果系统提示"无法验证开发者",请按以下步骤操作:
    • On the first launch, if you see a "Cannot verify developer" warning:
    • 前往 系统设置 > 隐私与安全性,在下方的安全部分点击"仍要打开"。
    • Go to System Settings > Privacy & Security, and in the security section at the bottom, click "Open Anyway".
    • 或者,右键点击应用图标,选择"打开"。
    • Alternatively, right-click the app icon and select "Open".

💡 如何使用 (Usage)

  • 启动应用 (Launch the App):
    • 启动后,应用图标会出现在屏幕右上角的状态栏中,同时会显示主设置窗口。
    • After launching, the app icon will appear in the menu bar at the top-right of your screen, and the main settings window will be displayed.
  • 启用/禁用 (Enable/Disable):
    • 在主窗口或状态栏菜单中,勾选/取消勾选 "启用自动切换" 即可控制应用。
    • Check/uncheck "Enable Auto Switch" in the main window or menu bar to control the app.
  • 隐藏窗口 (Hide Window):
    • 点击主窗口的关闭按钮或状态栏菜单的"隐藏"选项,可将窗口关闭,应用会继续在状态栏运行。
    • Click the close button on the main window or the "Hide" option in the menu to dismiss the window. The app will continue running in the menu bar.

⚙️ 工作原理 (How It Works)

  • 网络监控 (Network Monitoring):
    • 使用苹果现代化的 Network.framework 框架中的 NWPathMonitor 来实时、高效地监控网络连接状态的变化,特别是以太网接口的连接与断开。
    • It uses NWPathMonitor from Apple's modern Network.framework to efficiently monitor changes in network connection status in real time, especially for the Ethernet interface.
  • 自动切换 (Automated Toggling):
    • 当检测到以太网可用时,应用会调用系统底层的 networksetup 命令行工具来关闭 Wi-Fi 服务。
    • When an Ethernet connection becomes available, the app invokes the underlying networksetup command-line tool to turn off the Wi-Fi service.
    • 当以太网断开时,再次调用该工具重新开启 Wi-Fi 服务。
    • When the Ethernet connection is lost, it calls the tool again to re-enable the Wi-Fi service.
  • 延迟防抖 (Debouncing):
    • 内置了短暂的延迟机制,以避免在网络状态快速、频繁波动时(例如插拔网线的瞬间)执行不必要的重复切换。
    • A short delay is built-in to prevent unnecessary, repetitive switching during rapid network fluctuations (e.g., the moment of plugging/unplugging a cable).

👨‍💻 致开发者 (For Developers)

  • 若您想从源码构建本项目,请确保您已安装 Xcode。然后在项目根目录运行以下命令:
  • If you wish to build the project from the source, ensure you have Xcode installed. Then, run the following command in the project's root directory:
./build_release.sh
  • 该脚本将自动构建应用,并在项目根目录下生成可分发的 .dmg.zip 文件。
  • This script will build the application and create distributable .dmg and .zip files in the project's root directory.

📄 许可证 (License)

  • 本项目基于 GNU Affero General Public License v3.0 发布。详情请见 LICENSE 文件。
  • This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

About

一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
GitHub - lxy1992/NetworkSwitch: 一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected. · GitHub
Skip to content

Repository files navigation

NetworkSwitch - Mac 网络自动切换工具

NetworkSwitch - Automatic Network Switching Tool for Mac

  • 一款简洁的 macOS 状态栏应用,可以在检测到有线网络(以太网)接入时自动关闭 Wi-Fi,在有线网络断开时自动恢复 Wi-Fi 连接。
  • A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

🚀 主要功能 (Features)

  • ✅ 自动切换 (Automatic Switching):
    • 检测到以太网连接时,自动关闭 Wi-Fi。
    • When an Ethernet connection is detected, Wi-Fi is automatically turned off.
    • 以太网连接断开时,自动重新开启 Wi-Fi。
    • When the Ethernet connection is lost, Wi-Fi is automatically re-enabled.
  • ✅ 状态栏菜单 (Menu Bar Integration):
    • 所有核心功能都集成在状态栏菜单中,方便快速操作。
    • All core functions are integrated into the menu bar for quick access.
  • ✅ 开机自启 (Launch at Login):
    • 可在偏好设置中设为开机自动启动。
    • Can be configured to launch automatically at login via preferences.
  • ✅ 实时状态 (Real-time Status):
    • 状态栏图标和菜单会实时显示当前网络连接状态。
    • The menu bar icon and menu display the current network status in real time.
  • ✅ 系统通知 (System Notifications):
    • 每当网络状态发生自动切换时,都会收到系统通知。
    • Receive a system notification whenever an automatic network switch occurs.

💻 如何安装 (Installation)

  1. 下载应用 (Download the App)

    • 前往项目的 Releases 页面。
    • Go to the project's Releases page.
    • 下载最新版本的 NetworkSwitch-vX.X.X.dmg 文件。
    • Download the latest NetworkSwitch-vX.X.X.dmg file.
  2. 安装 (Install)

    • 双击打开 .dmg 文件。
    • Double-click the downloaded .dmg file.
    • NetworkSwitch.app 图标拖拽到 Applications (应用程序) 文件夹中。
    • Drag the NetworkSwitch.app icon into your Applications folder.
  3. 首次运行 (First Launch)

    • 首次打开应用时,如果系统提示"无法验证开发者",请按以下步骤操作:
    • On the first launch, if you see a "Cannot verify developer" warning:
    • 前往 系统设置 > 隐私与安全性,在下方的安全部分点击"仍要打开"。
    • Go to System Settings > Privacy & Security, and in the security section at the bottom, click "Open Anyway".
    • 或者,右键点击应用图标,选择"打开"。
    • Alternatively, right-click the app icon and select "Open".

💡 如何使用 (Usage)

  • 启动应用 (Launch the App):
    • 启动后,应用图标会出现在屏幕右上角的状态栏中,同时会显示主设置窗口。
    • After launching, the app icon will appear in the menu bar at the top-right of your screen, and the main settings window will be displayed.
  • 启用/禁用 (Enable/Disable):
    • 在主窗口或状态栏菜单中,勾选/取消勾选 "启用自动切换" 即可控制应用。
    • Check/uncheck "Enable Auto Switch" in the main window or menu bar to control the app.
  • 隐藏窗口 (Hide Window):
    • 点击主窗口的关闭按钮或状态栏菜单的"隐藏"选项,可将窗口关闭,应用会继续在状态栏运行。
    • Click the close button on the main window or the "Hide" option in the menu to dismiss the window. The app will continue running in the menu bar.

⚙️ 工作原理 (How It Works)

  • 网络监控 (Network Monitoring):
    • 使用苹果现代化的 Network.framework 框架中的 NWPathMonitor 来实时、高效地监控网络连接状态的变化,特别是以太网接口的连接与断开。
    • It uses NWPathMonitor from Apple's modern Network.framework to efficiently monitor changes in network connection status in real time, especially for the Ethernet interface.
  • 自动切换 (Automated Toggling):
    • 当检测到以太网可用时,应用会调用系统底层的 networksetup 命令行工具来关闭 Wi-Fi 服务。
    • When an Ethernet connection becomes available, the app invokes the underlying networksetup command-line tool to turn off the Wi-Fi service.
    • 当以太网断开时,再次调用该工具重新开启 Wi-Fi 服务。
    • When the Ethernet connection is lost, it calls the tool again to re-enable the Wi-Fi service.
  • 延迟防抖 (Debouncing):
    • 内置了短暂的延迟机制,以避免在网络状态快速、频繁波动时(例如插拔网线的瞬间)执行不必要的重复切换。
    • A short delay is built-in to prevent unnecessary, repetitive switching during rapid network fluctuations (e.g., the moment of plugging/unplugging a cable).

👨‍💻 致开发者 (For Developers)

  • 若您想从源码构建本项目,请确保您已安装 Xcode。然后在项目根目录运行以下命令:
  • If you wish to build the project from the source, ensure you have Xcode installed. Then, run the following command in the project's root directory:
./build_release.sh
  • 该脚本将自动构建应用,并在项目根目录下生成可分发的 .dmg.zip 文件。
  • This script will build the application and create distributable .dmg and .zip files in the project's root directory.

📄 许可证 (License)

  • 本项目基于 GNU Affero General Public License v3.0 发布。详情请见 LICENSE 文件。
  • This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

About

一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - lxy1992/NetworkSwitch: 一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected. · GitHub
Skip to content

Repository files navigation

NetworkSwitch - Mac 网络自动切换工具

NetworkSwitch - Automatic Network Switching Tool for Mac

  • 一款简洁的 macOS 状态栏应用,可以在检测到有线网络(以太网)接入时自动关闭 Wi-Fi,在有线网络断开时自动恢复 Wi-Fi 连接。
  • A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

🚀 主要功能 (Features)

  • ✅ 自动切换 (Automatic Switching):
    • 检测到以太网连接时,自动关闭 Wi-Fi。
    • When an Ethernet connection is detected, Wi-Fi is automatically turned off.
    • 以太网连接断开时,自动重新开启 Wi-Fi。
    • When the Ethernet connection is lost, Wi-Fi is automatically re-enabled.
  • ✅ 状态栏菜单 (Menu Bar Integration):
    • 所有核心功能都集成在状态栏菜单中,方便快速操作。
    • All core functions are integrated into the menu bar for quick access.
  • ✅ 开机自启 (Launch at Login):
    • 可在偏好设置中设为开机自动启动。
    • Can be configured to launch automatically at login via preferences.
  • ✅ 实时状态 (Real-time Status):
    • 状态栏图标和菜单会实时显示当前网络连接状态。
    • The menu bar icon and menu display the current network status in real time.
  • ✅ 系统通知 (System Notifications):
    • 每当网络状态发生自动切换时,都会收到系统通知。
    • Receive a system notification whenever an automatic network switch occurs.

💻 如何安装 (Installation)

  1. 下载应用 (Download the App)

    • 前往项目的 Releases 页面。
    • Go to the project's Releases page.
    • 下载最新版本的 NetworkSwitch-vX.X.X.dmg 文件。
    • Download the latest NetworkSwitch-vX.X.X.dmg file.
  2. 安装 (Install)

    • 双击打开 .dmg 文件。
    • Double-click the downloaded .dmg file.
    • NetworkSwitch.app 图标拖拽到 Applications (应用程序) 文件夹中。
    • Drag the NetworkSwitch.app icon into your Applications folder.
  3. 首次运行 (First Launch)

    • 首次打开应用时,如果系统提示"无法验证开发者",请按以下步骤操作:
    • On the first launch, if you see a "Cannot verify developer" warning:
    • 前往 系统设置 > 隐私与安全性,在下方的安全部分点击"仍要打开"。
    • Go to System Settings > Privacy & Security, and in the security section at the bottom, click "Open Anyway".
    • 或者,右键点击应用图标,选择"打开"。
    • Alternatively, right-click the app icon and select "Open".

💡 如何使用 (Usage)

  • 启动应用 (Launch the App):
    • 启动后,应用图标会出现在屏幕右上角的状态栏中,同时会显示主设置窗口。
    • After launching, the app icon will appear in the menu bar at the top-right of your screen, and the main settings window will be displayed.
  • 启用/禁用 (Enable/Disable):
    • 在主窗口或状态栏菜单中,勾选/取消勾选 "启用自动切换" 即可控制应用。
    • Check/uncheck "Enable Auto Switch" in the main window or menu bar to control the app.
  • 隐藏窗口 (Hide Window):
    • 点击主窗口的关闭按钮或状态栏菜单的"隐藏"选项,可将窗口关闭,应用会继续在状态栏运行。
    • Click the close button on the main window or the "Hide" option in the menu to dismiss the window. The app will continue running in the menu bar.

⚙️ 工作原理 (How It Works)

  • 网络监控 (Network Monitoring):
    • 使用苹果现代化的 Network.framework 框架中的 NWPathMonitor 来实时、高效地监控网络连接状态的变化,特别是以太网接口的连接与断开。
    • It uses NWPathMonitor from Apple's modern Network.framework to efficiently monitor changes in network connection status in real time, especially for the Ethernet interface.
  • 自动切换 (Automated Toggling):
    • 当检测到以太网可用时,应用会调用系统底层的 networksetup 命令行工具来关闭 Wi-Fi 服务。
    • When an Ethernet connection becomes available, the app invokes the underlying networksetup command-line tool to turn off the Wi-Fi service.
    • 当以太网断开时,再次调用该工具重新开启 Wi-Fi 服务。
    • When the Ethernet connection is lost, it calls the tool again to re-enable the Wi-Fi service.
  • 延迟防抖 (Debouncing):
    • 内置了短暂的延迟机制,以避免在网络状态快速、频繁波动时(例如插拔网线的瞬间)执行不必要的重复切换。
    • A short delay is built-in to prevent unnecessary, repetitive switching during rapid network fluctuations (e.g., the moment of plugging/unplugging a cable).

👨‍💻 致开发者 (For Developers)

  • 若您想从源码构建本项目,请确保您已安装 Xcode。然后在项目根目录运行以下命令:
  • If you wish to build the project from the source, ensure you have Xcode installed. Then, run the following command in the project's root directory:
./build_release.sh
  • 该脚本将自动构建应用,并在项目根目录下生成可分发的 .dmg.zip 文件。
  • This script will build the application and create distributable .dmg and .zip files in the project's root directory.

📄 许可证 (License)

  • 本项目基于 GNU Affero General Public License v3.0 发布。详情请见 LICENSE 文件。
  • This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

About

一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - lxy1992/NetworkSwitch: 一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected. · GitHub
Skip to content

Repository files navigation

NetworkSwitch - Mac 网络自动切换工具

NetworkSwitch - Automatic Network Switching Tool for Mac

  • 一款简洁的 macOS 状态栏应用,可以在检测到有线网络(以太网)接入时自动关闭 Wi-Fi,在有线网络断开时自动恢复 Wi-Fi 连接。
  • A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

🚀 主要功能 (Features)

  • ✅ 自动切换 (Automatic Switching):
    • 检测到以太网连接时,自动关闭 Wi-Fi。
    • When an Ethernet connection is detected, Wi-Fi is automatically turned off.
    • 以太网连接断开时,自动重新开启 Wi-Fi。
    • When the Ethernet connection is lost, Wi-Fi is automatically re-enabled.
  • ✅ 状态栏菜单 (Menu Bar Integration):
    • 所有核心功能都集成在状态栏菜单中,方便快速操作。
    • All core functions are integrated into the menu bar for quick access.
  • ✅ 开机自启 (Launch at Login):
    • 可在偏好设置中设为开机自动启动。
    • Can be configured to launch automatically at login via preferences.
  • ✅ 实时状态 (Real-time Status):
    • 状态栏图标和菜单会实时显示当前网络连接状态。
    • The menu bar icon and menu display the current network status in real time.
  • ✅ 系统通知 (System Notifications):
    • 每当网络状态发生自动切换时,都会收到系统通知。
    • Receive a system notification whenever an automatic network switch occurs.

💻 如何安装 (Installation)

  1. 下载应用 (Download the App)

    • 前往项目的 Releases 页面。
    • Go to the project's Releases page.
    • 下载最新版本的 NetworkSwitch-vX.X.X.dmg 文件。
    • Download the latest NetworkSwitch-vX.X.X.dmg file.
  2. 安装 (Install)

    • 双击打开 .dmg 文件。
    • Double-click the downloaded .dmg file.
    • NetworkSwitch.app 图标拖拽到 Applications (应用程序) 文件夹中。
    • Drag the NetworkSwitch.app icon into your Applications folder.
  3. 首次运行 (First Launch)

    • 首次打开应用时,如果系统提示"无法验证开发者",请按以下步骤操作:
    • On the first launch, if you see a "Cannot verify developer" warning:
    • 前往 系统设置 > 隐私与安全性,在下方的安全部分点击"仍要打开"。
    • Go to System Settings > Privacy & Security, and in the security section at the bottom, click "Open Anyway".
    • 或者,右键点击应用图标,选择"打开"。
    • Alternatively, right-click the app icon and select "Open".

💡 如何使用 (Usage)

  • 启动应用 (Launch the App):
    • 启动后,应用图标会出现在屏幕右上角的状态栏中,同时会显示主设置窗口。
    • After launching, the app icon will appear in the menu bar at the top-right of your screen, and the main settings window will be displayed.
  • 启用/禁用 (Enable/Disable):
    • 在主窗口或状态栏菜单中,勾选/取消勾选 "启用自动切换" 即可控制应用。
    • Check/uncheck "Enable Auto Switch" in the main window or menu bar to control the app.
  • 隐藏窗口 (Hide Window):
    • 点击主窗口的关闭按钮或状态栏菜单的"隐藏"选项,可将窗口关闭,应用会继续在状态栏运行。
    • Click the close button on the main window or the "Hide" option in the menu to dismiss the window. The app will continue running in the menu bar.

⚙️ 工作原理 (How It Works)

  • 网络监控 (Network Monitoring):
    • 使用苹果现代化的 Network.framework 框架中的 NWPathMonitor 来实时、高效地监控网络连接状态的变化,特别是以太网接口的连接与断开。
    • It uses NWPathMonitor from Apple's modern Network.framework to efficiently monitor changes in network connection status in real time, especially for the Ethernet interface.
  • 自动切换 (Automated Toggling):
    • 当检测到以太网可用时,应用会调用系统底层的 networksetup 命令行工具来关闭 Wi-Fi 服务。
    • When an Ethernet connection becomes available, the app invokes the underlying networksetup command-line tool to turn off the Wi-Fi service.
    • 当以太网断开时,再次调用该工具重新开启 Wi-Fi 服务。
    • When the Ethernet connection is lost, it calls the tool again to re-enable the Wi-Fi service.
  • 延迟防抖 (Debouncing):
    • 内置了短暂的延迟机制,以避免在网络状态快速、频繁波动时(例如插拔网线的瞬间)执行不必要的重复切换。
    • A short delay is built-in to prevent unnecessary, repetitive switching during rapid network fluctuations (e.g., the moment of plugging/unplugging a cable).

👨‍💻 致开发者 (For Developers)

  • 若您想从源码构建本项目,请确保您已安装 Xcode。然后在项目根目录运行以下命令:
  • If you wish to build the project from the source, ensure you have Xcode installed. Then, run the following command in the project's root directory:
./build_release.sh
  • 该脚本将自动构建应用,并在项目根目录下生成可分发的 .dmg.zip 文件。
  • This script will build the application and create distributable .dmg and .zip files in the project's root directory.

📄 许可证 (License)

  • 本项目基于 GNU Affero General Public License v3.0 发布。详情请见 LICENSE 文件。
  • This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

About

一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' GitHub - lxy1992/NetworkSwitch: 一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected. · GitHub
Skip to content

Repository files navigation

NetworkSwitch - Mac 网络自动切换工具

NetworkSwitch - Automatic Network Switching Tool for Mac

  • 一款简洁的 macOS 状态栏应用,可以在检测到有线网络(以太网)接入时自动关闭 Wi-Fi,在有线网络断开时自动恢复 Wi-Fi 连接。
  • A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

🚀 主要功能 (Features)

  • ✅ 自动切换 (Automatic Switching):
    • 检测到以太网连接时,自动关闭 Wi-Fi。
    • When an Ethernet connection is detected, Wi-Fi is automatically turned off.
    • 以太网连接断开时,自动重新开启 Wi-Fi。
    • When the Ethernet connection is lost, Wi-Fi is automatically re-enabled.
  • ✅ 状态栏菜单 (Menu Bar Integration):
    • 所有核心功能都集成在状态栏菜单中,方便快速操作。
    • All core functions are integrated into the menu bar for quick access.
  • ✅ 开机自启 (Launch at Login):
    • 可在偏好设置中设为开机自动启动。
    • Can be configured to launch automatically at login via preferences.
  • ✅ 实时状态 (Real-time Status):
    • 状态栏图标和菜单会实时显示当前网络连接状态。
    • The menu bar icon and menu display the current network status in real time.
  • ✅ 系统通知 (System Notifications):
    • 每当网络状态发生自动切换时,都会收到系统通知。
    • Receive a system notification whenever an automatic network switch occurs.

💻 如何安装 (Installation)

  1. 下载应用 (Download the App)

    • 前往项目的 Releases 页面。
    • Go to the project's Releases page.
    • 下载最新版本的 NetworkSwitch-vX.X.X.dmg 文件。
    • Download the latest NetworkSwitch-vX.X.X.dmg file.
  2. 安装 (Install)

    • 双击打开 .dmg 文件。
    • Double-click the downloaded .dmg file.
    • NetworkSwitch.app 图标拖拽到 Applications (应用程序) 文件夹中。
    • Drag the NetworkSwitch.app icon into your Applications folder.
  3. 首次运行 (First Launch)

    • 首次打开应用时,如果系统提示"无法验证开发者",请按以下步骤操作:
    • On the first launch, if you see a "Cannot verify developer" warning:
    • 前往 系统设置 > 隐私与安全性,在下方的安全部分点击"仍要打开"。
    • Go to System Settings > Privacy & Security, and in the security section at the bottom, click "Open Anyway".
    • 或者,右键点击应用图标,选择"打开"。
    • Alternatively, right-click the app icon and select "Open".

💡 如何使用 (Usage)

  • 启动应用 (Launch the App):
    • 启动后,应用图标会出现在屏幕右上角的状态栏中,同时会显示主设置窗口。
    • After launching, the app icon will appear in the menu bar at the top-right of your screen, and the main settings window will be displayed.
  • 启用/禁用 (Enable/Disable):
    • 在主窗口或状态栏菜单中,勾选/取消勾选 "启用自动切换" 即可控制应用。
    • Check/uncheck "Enable Auto Switch" in the main window or menu bar to control the app.
  • 隐藏窗口 (Hide Window):
    • 点击主窗口的关闭按钮或状态栏菜单的"隐藏"选项,可将窗口关闭,应用会继续在状态栏运行。
    • Click the close button on the main window or the "Hide" option in the menu to dismiss the window. The app will continue running in the menu bar.

⚙️ 工作原理 (How It Works)

  • 网络监控 (Network Monitoring):
    • 使用苹果现代化的 Network.framework 框架中的 NWPathMonitor 来实时、高效地监控网络连接状态的变化,特别是以太网接口的连接与断开。
    • It uses NWPathMonitor from Apple's modern Network.framework to efficiently monitor changes in network connection status in real time, especially for the Ethernet interface.
  • 自动切换 (Automated Toggling):
    • 当检测到以太网可用时,应用会调用系统底层的 networksetup 命令行工具来关闭 Wi-Fi 服务。
    • When an Ethernet connection becomes available, the app invokes the underlying networksetup command-line tool to turn off the Wi-Fi service.
    • 当以太网断开时,再次调用该工具重新开启 Wi-Fi 服务。
    • When the Ethernet connection is lost, it calls the tool again to re-enable the Wi-Fi service.
  • 延迟防抖 (Debouncing):
    • 内置了短暂的延迟机制,以避免在网络状态快速、频繁波动时(例如插拔网线的瞬间)执行不必要的重复切换。
    • A short delay is built-in to prevent unnecessary, repetitive switching during rapid network fluctuations (e.g., the moment of plugging/unplugging a cable).

👨‍💻 致开发者 (For Developers)

  • 若您想从源码构建本项目,请确保您已安装 Xcode。然后在项目根目录运行以下命令:
  • If you wish to build the project from the source, ensure you have Xcode installed. Then, run the following command in the project's root directory:
./build_release.sh
  • 该脚本将自动构建应用,并在项目根目录下生成可分发的 .dmg.zip 文件。
  • This script will build the application and create distributable .dmg and .zip files in the project's root directory.

📄 许可证 (License)

  • 本项目基于 GNU Affero General Public License v3.0 发布。详情请见 LICENSE 文件。
  • This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

About

一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - lxy1992/NetworkSwitch: 一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected. · GitHub
Skip to content

Repository files navigation

NetworkSwitch - Mac 网络自动切换工具

NetworkSwitch - Automatic Network Switching Tool for Mac

  • 一款简洁的 macOS 状态栏应用,可以在检测到有线网络(以太网)接入时自动关闭 Wi-Fi,在有线网络断开时自动恢复 Wi-Fi 连接。
  • A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

🚀 主要功能 (Features)

  • ✅ 自动切换 (Automatic Switching):
    • 检测到以太网连接时,自动关闭 Wi-Fi。
    • When an Ethernet connection is detected, Wi-Fi is automatically turned off.
    • 以太网连接断开时,自动重新开启 Wi-Fi。
    • When the Ethernet connection is lost, Wi-Fi is automatically re-enabled.
  • ✅ 状态栏菜单 (Menu Bar Integration):
    • 所有核心功能都集成在状态栏菜单中,方便快速操作。
    • All core functions are integrated into the menu bar for quick access.
  • ✅ 开机自启 (Launch at Login):
    • 可在偏好设置中设为开机自动启动。
    • Can be configured to launch automatically at login via preferences.
  • ✅ 实时状态 (Real-time Status):
    • 状态栏图标和菜单会实时显示当前网络连接状态。
    • The menu bar icon and menu display the current network status in real time.
  • ✅ 系统通知 (System Notifications):
    • 每当网络状态发生自动切换时,都会收到系统通知。
    • Receive a system notification whenever an automatic network switch occurs.

💻 如何安装 (Installation)

  1. 下载应用 (Download the App)

    • 前往项目的 Releases 页面。
    • Go to the project's Releases page.
    • 下载最新版本的 NetworkSwitch-vX.X.X.dmg 文件。
    • Download the latest NetworkSwitch-vX.X.X.dmg file.
  2. 安装 (Install)

    • 双击打开 .dmg 文件。
    • Double-click the downloaded .dmg file.
    • NetworkSwitch.app 图标拖拽到 Applications (应用程序) 文件夹中。
    • Drag the NetworkSwitch.app icon into your Applications folder.
  3. 首次运行 (First Launch)

    • 首次打开应用时,如果系统提示"无法验证开发者",请按以下步骤操作:
    • On the first launch, if you see a "Cannot verify developer" warning:
    • 前往 系统设置 > 隐私与安全性,在下方的安全部分点击"仍要打开"。
    • Go to System Settings > Privacy & Security, and in the security section at the bottom, click "Open Anyway".
    • 或者,右键点击应用图标,选择"打开"。
    • Alternatively, right-click the app icon and select "Open".

💡 如何使用 (Usage)

  • 启动应用 (Launch the App):
    • 启动后,应用图标会出现在屏幕右上角的状态栏中,同时会显示主设置窗口。
    • After launching, the app icon will appear in the menu bar at the top-right of your screen, and the main settings window will be displayed.
  • 启用/禁用 (Enable/Disable):
    • 在主窗口或状态栏菜单中,勾选/取消勾选 "启用自动切换" 即可控制应用。
    • Check/uncheck "Enable Auto Switch" in the main window or menu bar to control the app.
  • 隐藏窗口 (Hide Window):
    • 点击主窗口的关闭按钮或状态栏菜单的"隐藏"选项,可将窗口关闭,应用会继续在状态栏运行。
    • Click the close button on the main window or the "Hide" option in the menu to dismiss the window. The app will continue running in the menu bar.

⚙️ 工作原理 (How It Works)

  • 网络监控 (Network Monitoring):
    • 使用苹果现代化的 Network.framework 框架中的 NWPathMonitor 来实时、高效地监控网络连接状态的变化,特别是以太网接口的连接与断开。
    • It uses NWPathMonitor from Apple's modern Network.framework to efficiently monitor changes in network connection status in real time, especially for the Ethernet interface.
  • 自动切换 (Automated Toggling):
    • 当检测到以太网可用时,应用会调用系统底层的 networksetup 命令行工具来关闭 Wi-Fi 服务。
    • When an Ethernet connection becomes available, the app invokes the underlying networksetup command-line tool to turn off the Wi-Fi service.
    • 当以太网断开时,再次调用该工具重新开启 Wi-Fi 服务。
    • When the Ethernet connection is lost, it calls the tool again to re-enable the Wi-Fi service.
  • 延迟防抖 (Debouncing):
    • 内置了短暂的延迟机制,以避免在网络状态快速、频繁波动时(例如插拔网线的瞬间)执行不必要的重复切换。
    • A short delay is built-in to prevent unnecessary, repetitive switching during rapid network fluctuations (e.g., the moment of plugging/unplugging a cable).

👨‍💻 致开发者 (For Developers)

  • 若您想从源码构建本项目,请确保您已安装 Xcode。然后在项目根目录运行以下命令:
  • If you wish to build the project from the source, ensure you have Xcode installed. Then, run the following command in the project's root directory:
./build_release.sh
  • 该脚本将自动构建应用,并在项目根目录下生成可分发的 .dmg.zip 文件。
  • This script will build the application and create distributable .dmg and .zip files in the project's root directory.

📄 许可证 (License)

  • 本项目基于 GNU Affero General Public License v3.0 发布。详情请见 LICENSE 文件。
  • This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

About

一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); GitHub - lxy1992/NetworkSwitch: 一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected. · GitHub
Skip to content

Repository files navigation

NetworkSwitch - Mac 网络自动切换工具

NetworkSwitch - Automatic Network Switching Tool for Mac

  • 一款简洁的 macOS 状态栏应用,可以在检测到有线网络(以太网)接入时自动关闭 Wi-Fi,在有线网络断开时自动恢复 Wi-Fi 连接。
  • A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

🚀 主要功能 (Features)

  • ✅ 自动切换 (Automatic Switching):
    • 检测到以太网连接时,自动关闭 Wi-Fi。
    • When an Ethernet connection is detected, Wi-Fi is automatically turned off.
    • 以太网连接断开时,自动重新开启 Wi-Fi。
    • When the Ethernet connection is lost, Wi-Fi is automatically re-enabled.
  • ✅ 状态栏菜单 (Menu Bar Integration):
    • 所有核心功能都集成在状态栏菜单中,方便快速操作。
    • All core functions are integrated into the menu bar for quick access.
  • ✅ 开机自启 (Launch at Login):
    • 可在偏好设置中设为开机自动启动。
    • Can be configured to launch automatically at login via preferences.
  • ✅ 实时状态 (Real-time Status):
    • 状态栏图标和菜单会实时显示当前网络连接状态。
    • The menu bar icon and menu display the current network status in real time.
  • ✅ 系统通知 (System Notifications):
    • 每当网络状态发生自动切换时,都会收到系统通知。
    • Receive a system notification whenever an automatic network switch occurs.

💻 如何安装 (Installation)

  1. 下载应用 (Download the App)

    • 前往项目的 Releases 页面。
    • Go to the project's Releases page.
    • 下载最新版本的 NetworkSwitch-vX.X.X.dmg 文件。
    • Download the latest NetworkSwitch-vX.X.X.dmg file.
  2. 安装 (Install)

    • 双击打开 .dmg 文件。
    • Double-click the downloaded .dmg file.
    • NetworkSwitch.app 图标拖拽到 Applications (应用程序) 文件夹中。
    • Drag the NetworkSwitch.app icon into your Applications folder.
  3. 首次运行 (First Launch)

    • 首次打开应用时,如果系统提示"无法验证开发者",请按以下步骤操作:
    • On the first launch, if you see a "Cannot verify developer" warning:
    • 前往 系统设置 > 隐私与安全性,在下方的安全部分点击"仍要打开"。
    • Go to System Settings > Privacy & Security, and in the security section at the bottom, click "Open Anyway".
    • 或者,右键点击应用图标,选择"打开"。
    • Alternatively, right-click the app icon and select "Open".

💡 如何使用 (Usage)

  • 启动应用 (Launch the App):
    • 启动后,应用图标会出现在屏幕右上角的状态栏中,同时会显示主设置窗口。
    • After launching, the app icon will appear in the menu bar at the top-right of your screen, and the main settings window will be displayed.
  • 启用/禁用 (Enable/Disable):
    • 在主窗口或状态栏菜单中,勾选/取消勾选 "启用自动切换" 即可控制应用。
    • Check/uncheck "Enable Auto Switch" in the main window or menu bar to control the app.
  • 隐藏窗口 (Hide Window):
    • 点击主窗口的关闭按钮或状态栏菜单的"隐藏"选项,可将窗口关闭,应用会继续在状态栏运行。
    • Click the close button on the main window or the "Hide" option in the menu to dismiss the window. The app will continue running in the menu bar.

⚙️ 工作原理 (How It Works)

  • 网络监控 (Network Monitoring):
    • 使用苹果现代化的 Network.framework 框架中的 NWPathMonitor 来实时、高效地监控网络连接状态的变化,特别是以太网接口的连接与断开。
    • It uses NWPathMonitor from Apple's modern Network.framework to efficiently monitor changes in network connection status in real time, especially for the Ethernet interface.
  • 自动切换 (Automated Toggling):
    • 当检测到以太网可用时,应用会调用系统底层的 networksetup 命令行工具来关闭 Wi-Fi 服务。
    • When an Ethernet connection becomes available, the app invokes the underlying networksetup command-line tool to turn off the Wi-Fi service.
    • 当以太网断开时,再次调用该工具重新开启 Wi-Fi 服务。
    • When the Ethernet connection is lost, it calls the tool again to re-enable the Wi-Fi service.
  • 延迟防抖 (Debouncing):
    • 内置了短暂的延迟机制,以避免在网络状态快速、频繁波动时(例如插拔网线的瞬间)执行不必要的重复切换。
    • A short delay is built-in to prevent unnecessary, repetitive switching during rapid network fluctuations (e.g., the moment of plugging/unplugging a cable).

👨‍💻 致开发者 (For Developers)

  • 若您想从源码构建本项目,请确保您已安装 Xcode。然后在项目根目录运行以下命令:
  • If you wish to build the project from the source, ensure you have Xcode installed. Then, run the following command in the project's root directory:
./build_release.sh
  • 该脚本将自动构建应用,并在项目根目录下生成可分发的 .dmg.zip 文件。
  • This script will build the application and create distributable .dmg and .zip files in the project's root directory.

📄 许可证 (License)

  • 本项目基于 GNU Affero General Public License v3.0 发布。详情请见 LICENSE 文件。
  • This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

About

一个简洁的 macOS 状态栏应用,可以自动在以太网和 WiFi 之间切换,解决网络连接优先级问题。 A lightweight macOS menu bar application that automatically turns off Wi-Fi when an Ethernet connection is detected and turns it back on when Ethernet is disconnected.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages