🌉 GroupCord

GroupCord

The easiest way to bridge Discord and GroupMe.

Sync messages, images, replies, edits, deletes, and more between Discord and GroupMe in minutes.

---

✨ Features

Discord → GroupMe

• ✅ Messages
• ✅ Images
• ✅ Replies
• ✅ Edit Notifications
• ✅ Delete Notifications

GroupMe → Discord

• ✅ Messages
• ✅ Images
• ✅ Replies
• ✅ Usernames
• ✅ User Avatars

General

• 🌉 Multiple Bridges
• ⚡ Automatic Discord Webhooks
• ☁️ Cloud Hosted
• 💾 SQLite Database
• 🚀 Quick Setup
• 🆓 Open Source

---

🚀 Getting Started

Deploy your own GroupCord backend for free using Northflank while using the official GroupCord Discord bot.

Average setup time: 10–15 minutes

---

Step 1 — Invite the Official GroupCord Bot

Click the button at the top of this page to invite the official GroupCord bot to your Discord server.

💡 Tip: Right-click the Invite GroupCord button and choose "Open Link in New Tab" so you can continue following this guide while inviting the bot.

---

Step 2 — Create a GroupMe Bot

Visit:

https://dev.groupme.com/bots

Create a bot inside your GroupMe group.

Save your:

• GroupMe Bot ID
• GroupMe Access Token

---

Step 3 — Fork This Repository

Fork this repository to your GitHub account.

---

Step 4 — Create a Northflank Account

Visit:

https://northflank.com

Sign in using GitHub.

---

Step 5 — Create a Project

Click New Project.

Name it anything you'd like.

Example:

GroupCord

---

Step 6 — Create a Service

Inside your project:

Click Create Service

Choose:

From Git Repository

Select your fork of GroupCord.

Deployment Type:

Buildpack

---

Step 7 — Configure Runtime Variables

Add the following Runtime Variables:

DISCORD_TOKEN=YOUR_DISCORD_BOT_TOKEN

CLIENT_ID=YOUR_DISCORD_APPLICATION_ID

GUILD_ID=YOUR_DISCORD_SERVER_ID

GROUPME_ACCESS_TOKEN=YOUR_GROUPME_ACCESS_TOKEN

GROUPME_BOT_ID=YOUR_GROUPME_BOT_ID

PORT=3000

Click Create Service.

Wait until the logs display:

🚀 GroupCord is online!

---

Step 8 — Configure Your GroupMe Callback

Northflank will generate a public URL similar to:

https://groupcord-xxxxx.code.run

Copy the URL.

Return to:

https://dev.groupme.com/bots

Edit your GroupMe bot.

Set the Callback URL to:

https://YOUR-NORTHFLANK-URL/webhook/groupme/YOUR_GROUPME_BOT_ID

Example:

https://groupcord-abc123.code.run/webhook/groupme/325cf6495ff62383cae340bec9

Save your changes.

---

Step 9 — Create Your First Bridge

Inside Discord run:

/setup

Choose:

• Discord Channel
• GroupMe Bot ID

Press Enter.

🎉 That's it!

Your Discord server and GroupMe group are now connected.

---

✅ Verify Everything Works

Send a message in Discord.

It should appear in GroupMe.

Send a message in GroupMe.

It should appear in Discord.

If both tests succeed, your bridge is working correctly.

---

⚠️ Free Northflank Storage

GroupCord currently uses SQLite to store bridge configurations.

On Northflank's free plan, application storage is temporary.

This means that bridge configurations are reset whenever the application is redeployed, such as after pushing a new update from GitHub.

Don't worry—your deployment, bot, and GroupMe configuration are not lost.

Simply run:

/setup

again for each bridge you want to reconnect.

This usually takes less than a minute.

Future versions of GroupCord will support persistent databases to eliminate this limitation.

---

Commands

Command	Description
/setup	Create or update a bridge
/bridges	View all configured bridges
/unlink	Remove a bridge
/status	Check bridge status
/ping	Verify the bot is online

---

How It Works

Discord
     │
     ▼
Discord Gateway
     │
  GroupCord
     │
Express Web Server
     │
     ▼
GroupMe Callback

---

Local Development

This section is intended for developers contributing to GroupCord.

Clone the repository:

git clone https://github.com/camdaloon/GroupCord.git

Install dependencies:

npm install

Copy the environment file.

Windows:

copy .env.example .env

Linux/macOS:

cp .env.example .env

Run:

npm start

If testing locally, expose port 3000 with ngrok:

ngrok http 3000

Then update your GroupMe callback URL.

---

Roadmap

Upcoming features:

• 🌐 Web Dashboard
• 🐳 Docker Support
• 📈 Bridge Analytics
• 😀 Better Emoji Support
• 📁 Additional Attachment Support
• ☁️ PostgreSQL Support
• 🔐 Discord OAuth
• 🗳️ Voting System

See ROADMAP.md for the complete roadmap.

---

Contributing

Contributions are always welcome!

Please read:

CONTRIBUTING.md

before opening a Pull Request.

---

License

This project is licensed under the MIT License.

See:

LICENSE

---

Screenshots

Coming Soon

• Discord → GroupMe
• GroupMe → Discord
• Images
• Replies
• Web Dashboard

---

Made by camdaloon