Skip to main content
EcoleDirecte is a popular school management platform used by educational institutions across France. Papillon integrates seamlessly with EcoleDirecte to provide access to grades, homework, timetables, and more.

​
Overview

The EcoleDirecte integration uses the @blockshub/blocksdirecte library to communicate with EcoleDirecte’s API. Unlike some platforms, EcoleDirecte capabilities are fixed and don’t require dynamic detection.
EcoleDirecte provides a consistent set of features across all schools using the platform.

​
Supported Features

Papillon’s EcoleDirecte integration includes:

Grades

View grades by period with averages and statistics

Homework

Track assignments and mark them complete

Timetable

Access your weekly class schedule

Attendance

Monitor absences and presence records

Messaging

Read messages from teachers and staff

News

Read school announcements and updates

Balance

Check your school account balance

​
Detailed Feature List

The homework feature allows you to:
  • View assignments organized by week
  • See assignment details, descriptions, and due dates
  • Mark homework as done or incomplete
  • Track completion status across subjects
Capability: HOMEWORK
Access your academic records including:
  • Grades organized by evaluation period
  • Subject averages and class averages
  • Grade statistics and rankings
  • Teacher comments and observations
  • Historical grade data
Capability: GRADES
View your class schedule with:
  • Weekly timetable display
  • Class locations and room numbers
  • Teacher assignments
  • Subject information
Capability: TIMETABLE
Monitor your attendance including:
  • Absence records
  • Delay notifications
  • Attendance statistics
  • Justification status
Capability: ATTENDANCE
Communicate with teachers and staff:
  • Read received messages
  • View message threads
  • Access message content and attachments
  • See sender information and dates
Capability: CHAT
Stay informed with:
  • School-wide announcements
  • Important notices from administration
  • Event information
  • News from teachers
Capability: NEWS

​
Connecting to EcoleDirecte

Setting up your EcoleDirecte connection is straightforward:
1

Select EcoleDirecte

When adding a new account in Papillon, choose EcoleDirecte from the list of available platforms.
2

Enter Your Username

Provide your EcoleDirecte username. This is typically:
  • Your school-provided identifier
  • Sometimes your email address
  • Or a numeric student ID
Use the same username you use to log into the EcoleDirecte website or mobile app.
3

Enter Your Password

Provide your EcoleDirecte password.
Your password is stored securely on your device. Papillon never sends your credentials to third parties.
4

Authentication

Papillon will authenticate with EcoleDirecte and generate an access token. A unique device UUID is created to identify your device.
5

Account Selection

If your account is associated with multiple students (parent accounts), you’ll select the student account to use. Papillon automatically selects the first account by default.
6

Start Using Papillon

Once connected, all EcoleDirecte features are immediately available in Papillon.

​
Authentication Details

EcoleDirecte uses a token-based authentication system: 
Authentication Requirements:
- Username (school-provided identifier)
- Password
- Account Type: "E" (for Élève/Student)
- Device UUID (automatically generated)
- Token (generated after first login)

​
How Authentication Works

  1. Initial Login: Papillon sends your credentials to EcoleDirecte’s API
  2. Token Generation: EcoleDirecte returns an access token
  3. Token Storage: The token is securely stored on your device
  4. Token Refresh: The token is used for all subsequent requests
  5. Automatic Refresh: Papillon automatically refreshes your session as needed
EcoleDirecte tokens remain valid for extended periods. Papillon handles token refresh automatically, so you rarely need to log in again.

​
Available Capabilities

Unlike Pronote’s dynamic capabilities, EcoleDirecte provides a fixed set of features:
FeatureStatusDescription
Homework✓ Always AvailableView and manage assignments
Grades✓ Always AvailableAccess grades and evaluations
Timetable✓ Always AvailableView class schedule
Attendance✓ Always AvailableMonitor attendance records
News✓ Always AvailableRead school announcements
Balance✓ Always AvailableCheck account balance
Messaging✗ Not SupportedEcoleDirecte messaging not yet integrated
Canteen Menu✗ Not AvailableNot provided by EcoleDirecte API
All features are enabled by default. If you can’t access a feature, it may be restricted by your school’s account permissions.

​
Data Synchronization

EcoleDirecte data syncs with the following behavior:
  • Manual Refresh: Pull down on any screen to refresh data
  • Session Persistence: Your session remains active between app launches
  • Automatic Updates: Data is fetched on-demand when you navigate to different sections
  • Cache Strategy: Recent data is cached to improve performance
If you experience sync issues, try manually refreshing. If problems persist, disconnect and reconnect your account.

​
Common Issues & Solutions

Problem: Can’t connect to your EcoleDirecte account.Solutions:
  • Verify your username and password are correct
  • Try logging into EcoleDirecte’s website to confirm credentials
  • Check your internet connection
  • Ensure your EcoleDirecte account is active
  • Contact your school if account is locked
Problem: Connected successfully but no data appears.Solutions:
  • Pull down to manually refresh
  • Check if data is available on EcoleDirecte’s website
  • Your school may not have published data yet
  • Try disconnecting and reconnecting your account
Problem: Getting session expired errors.Solutions:
  • Papillon should automatically refresh your session
  • Try manually refreshing the app
  • If the issue persists, log out and log back in
  • Check if you changed your password on EcoleDirecte’s website
Problem: Showing data for the wrong student (parent accounts).Solutions:
  • EcoleDirecte may have multiple student profiles linked
  • Currently, Papillon uses the first account (index 0)
  • You may need to create separate connections for each student

​
Parent Accounts

For parents with multiple children:
Parent accounts can access data for multiple students. Currently, Papillon automatically selects the first student account. To access data for other students, you can add multiple EcoleDirecte accounts to Papillon.

​
Privacy & Security

EcoleDirecte integration security features:
  • ✓ Local credential storage with device encryption
  • ✓ Token-based authentication (no password in memory)
  • ✓ HTTPS encrypted communication
  • ✓ Unique device UUID for identification
  • ✓ Automatic session cleanup on logout
  • ✓ No third-party data sharing

​
Technical Implementation

The EcoleDirecte integration is built using:
  • Library: @blockshub/blocksdirecte - TypeScript client for EcoleDirecte API
  • Authentication: Token-based with automatic refresh
  • Session Management: Client instance maintains connection state
  • Account Selection: Automatic selection of first student account
Implementation reference: /services/ecoledirecte/index.ts

​
Feature Comparison

​
EcoleDirecte vs Pronote

FeatureEcoleDirectePronote
Grades✓✓
Homework✓✓
Timetable✓✓
Attendance✓✓
News✓✓
Messaging✗✓
Canteen Menu✗✓
Balance✓✗
Dynamic Capabilities✗✓

​
Best Practices

Regular Syncing

Pull down to refresh data regularly for the latest updates

Password Updates

Update your Papillon credentials when you change your EcoleDirecte password

Multiple Accounts

Add separate accounts for each child if you’re a parent

Data Privacy

Your data stays on your device - no cloud storage

​
Getting Help

If you experience issues with your EcoleDirecte integration:
  1. Check the troubleshooting section above
  2. Verify your credentials work on EcoleDirecte’s official website
  3. Try disconnecting and reconnecting your account
  4. Contact your school’s IT support for account-related issues
  5. Report bugs on Papillon’s GitHub

​
Next Steps

Features Overview

Explore what you can do with Papillon

All Integrations

See other supported platforms

Build docs developers (and LLMs) love

Get started for freeTalk to us